- SNAPSHOT({Y | N})
-
Specifies whether or not you
want CEA to preserve snapshots of log information about incidents.
- If Y, every time an SVC Dump is taken, CEA will capture the specified
amount of operlog, logrec detail, and logrec summary information for
review by the IBM® Support Center,
if necessary. N is the default. Y is the recommended setting when
using the CIM IBMzOS_Incident support. The default amounts are 30 minutes of Operlog, one hour of Logrec detail
and a 4-hour Logrec summary report. (The System
Logger needs to be set up before OPERLOG or LOGREC snapshots can be
taken.)
- If N, the log data will not be captured and will not be available
for review by the IBM Support
Center.
- HLQLONG(CEA)
-
Specifies the high-level qualifier
for all log snapshot data sets that are created when SNAPSHOT(Y) is
specified. These data sets are of snapshot log streams, prepared data
sets used for service, and other associated diagnostic information.
You
can adjust this to a different 1- to 8-character qualifier of your
own choice. The first character cannot be a number. This value will
default to CEA.
If both the HLQLONG and HLQ
statements are specified, processing will be done according to the
following rules:
- All new diagnostic information will be constructed with the HLQLONG
high-level qualifier.
- When searching for specific diagnostic information, the search
will first be performed with the HLQLONG value as the high-level qualifier.
If no search results are found, a second search will be performed
using the HLQ value as the high-level qualifier. If both searches
yield no results, the information does not exist.
Note: You are not required to migrate to the longer high-level
qualifier. To continue to use your existing configuration, do not
specify the HLQLONG statement.
- HLQ(CEA)
-
Specifies the high-level qualifier
for all log snapshot data sets that are created when SNAPSHOT(Y) is
specified. These data sets are of snapshot log streams, prepared data
sets used for service, and other associated diagnostic information.
You
can adjust this to a different 1- to 4-character qualifier of your
own choice. The first character cannot be a number. This value will
default to CEA.
If both the HLQLONG and HLQ
statements are specified, processing will be done according to the
following rules:
- All new diagnostic information will be constructed with the HLQLONG
high-level qualifier.
- When searching for specific diagnostic information, the search
will first be performed with the HLQLONG value as the high-level qualifier.
If no search results are found, a second search will be performed
using the HLQ value as the high-level qualifier. If both searches
yield no results, the information does not exist.
- BRANCH(branchoffice),COUNTRYCODE(countrycode)
-
Specifies the branch and country
code for use in sending data to the IBM Support
Center.
- BRANCH (branchoffice) specifies
the branch office, typically a three character
value.
- COUNTRYCODE (countrycode) specifies the country
code, typically a three character value.
There are no defaults for these values.
- DUMPCAPTURETIME
- Specifies the amount of diagnostic
data to be captured for different types of dumps. This statement consists
of 1 to 3 other statements (SLIP, DUMP or ABEND).
- SLIP
- Specifies
the amount of diagnostic data to be captured with SLIP dumps, measured
in time (hours, minutes). The default amounts are 30
minutes of Operlog, one hour of Logrec detail and a 4-hour Logrec summary report.
This statement
is an operand of DUMPCAPTURETIME.
- DUMP
- Specifies
the amount of diagnostic data to be captured with DUMP command dumps,
measured in time (hours, minutes). The default amounts are 30 minutes of Operlog, one hour of Logrec detail
and a 4-hour Logrec summary report.
This
statement is an operand of DUMPCAPTURETIME.
- ABEND
- Specifies
the amount of diagnostic data to be captured with system ABEND dumps,
measured in time (hours, minutes). The default amounts are 30 minutes of Operlog, one hour of Logrec detail
and a 4-hour Logrec summary report.
This
statement is an operand of DUMPCAPTURETIME.
The following statements are operands of the SLIP,
DUMP and ABEND statements of DUMPCAPTURETIME.
- OPERLOG
- Specifies
the amount of OPERLOG data to be captured with the dump type. The maximum value of OPERLOG is 24 hours.
This
statement is an operand of SLIP, DUMP and ABEND.
- LOGREC
- Specifies
the amount of LOGREC data to be captured with the dump type. The maximum value of LOGREC is 24 hours.
This
statement is an operand of SLIP, DUMP and ABEND.
- LOGRECSUMMARY
- Specifies
the amount of LOGRECSUMMARY data to be captured with the dump type. The maximum value of LOGRECSUMMARY is 4 hours.
This
statement is an operand of SLIP, DUMP and ABEND.
The
amount of data captured depends on how the LOGREC information is configured
on your system. If the LOGREC information is written to a logstream,
the value is rounded to the nearest 1-hour interval. If the LOGREC
information is written to a logger data set, the value closely approximates
the capture time for the request and is not rounded.
- STORAGE(STORCLAS(stgclass))
- Specifies the SMS class you request
the system to use for allocation of incident data sets. stgclass is
the one- to eight-character name of the SMS storage class that you
request to add.
- STORAGE(VOLSER(volume[,volume[,volume[...]]]))
- Specifies the non-SMS-managed direct
access volumes to use for automatic allocation of various incident
related data sets. Allocation assigns space from the first volume
in the list until that volume is full, and then uses the next volume.
volume is
the 1-6 character volume serial identifier of the direct access volume
that you want to add to the system’s list of resources for automatic
allocation. You can specify one to eight direct access volume serial
identifiers. Separate the volume serial identifiers with commas.
Note: The
storage specified is used to indicate where various data sets are
to be allocated during processing. Storage is used for logrec snapshot
reports, prepared data sets for the dumps, the logrec reports, the
operlogs, and table information.
- TSOASMGR
- Specifies the ability for TSO/E
address spaces to be considered reconnectable for a user; that is,
the user is able to reconnect to a TSO/E user session from which the
user has requested to log off but that the system has not yet ended
(dormant). The next time a request is made to create an address space
for that user (through the CEA TSO address space manager services),
the address space will be reconnected. The user security credentials
and log on information for a reconnectable address space must match
those of the original user in order for the system to perform the
reconnect.
The statement consists of 1 to 2 statements (RECONSESSIONS
and RECONTIME.)
Note: There is an inherent imprecision between
the reconnect time interval specified by RECONTIME or the number of
sessions requested specified by RECONSESSIONS and the behavior of
a running system. The values are enforced at logical times on a system.
Logical times occur when creating a session, ending a session, or
reaching a system monitor interval of ten (10) minutes.
For example,
the TSO/E sessions might have expired before the monitoring interval
occurs but will not be removed until the monitoring interval has elapsed.
It is possible for sessions that have expired their reconnect time
interval to still appear on the system. They are in an expired state,
and will not be used for reconnection. These sessions will be removed
from the system. However, there may be a delay in this removal,
and this delay can be as much as ten (10) minutes after the RECONTIME
interval has expired. This delay is due to processing the cleanup
of the sessions.
- RECONSESSIONS (n)
- Specifies
the number of sessions that the system considers dormant (that is,
the user has requested to log off but the session is not ended) and
available for that user to reconnect. n can
be a value in the range 0 - 3. A value of 0 disables this function
and is the default.
A non-zero value for
n allows
the specified number of sessions to be considered ended and available
to be reconnected for that user. The maximum value is three (3). This
value can be changed by the following system command:
F CEA,CEA=xx
Note
that it takes some time for the new values to be integrated into the
system. The in-flight sessions will remain until the next time CEA
enforces the values. (See
Note above.)
This statement
is an operand of TSOASMGR.
- RECONTIME (hh:mm:ss)
- RECONTIME
Specifies the amount of time that a session will remain dorman (the
user has requested to log off but the session is not ended) in the
format hh:mm:ss, where hh is
hours, mm is minutes, and ss is
seconds. A value of 00:00:00 disables this function and is the default.
A value of 00:00:01 or greater specifies the amount of time
an address space remains a candidate for reconnection before it is
ended. The maximum value is 23:59:59. This value can be changed by
the following system command:
F CEA,CEA=xx
Note
that it takes some time for the new values to be integrated into the
system. The in-flight sessions will remain until the next time CEA
enforces the values. (See
Note above.)
This statement
is an operand of TSOASMGR.