Statements/parameters for CEAPRMxx

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.
Start of changeHLQLONG(CEA)End of change
Start of change

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.
End of change
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.

Start of changeIf 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.
End of change
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.