CSLSIxxx member of the IMS PROCLIB data set

Some parameters within CSLSIxxx can be overridden using SCI execution parameters.

You can use the IMS Syntax Checker to modify this member of the IMS PROCLIB data set.

Syntax

Usage

This member of the IMS PROCLIB data set consists of one or more fixed-length character records (the configuration data set can be of any LRECL greater than eight, but it must be fixed record format). The rightmost-eight columns are ignored but can be used for sequence numbers or any other notation. Keyword parameters can be coded in the remaining columns in free format, and can contain leading and trailing blanks. You can specify multiple keywords in each record; use commas or spaces to delimit keywords. Statements that begin with a * or # in column 1 are comment lines and are ignored. Additionally, comments can be included anywhere within a statement by enclosing them between /* and */, for example, /* PROCLIB comments */. Values coded in this member of the IMS PROCLIB data set are case sensitive. In general, you should use uppercase for all parameters.

BPE considerations

Use the SCI BPE user exit list member of the IMS PROCLIB data set to define SCI user exits to BPE. This is the member specified by the EXITMBR= parameter in the BPE configuration parameter member of the IMS PROCLIB data set.

Use the user exit list member of the IMS PROCLIB data set to specify the modules to be called for specific exit types. Each user exit type can have one or more exit modules associated with it. Use the EXITDEF statement to define the user exit modules to be called for a given exit type.

A sample SCI user exit list member of the IMS PROCLIB data set is shown in Sample SCI user exit list member of the IMS PROCLIB data set.

Parameters

The parameters associated with the syntax diagram are added next.

ARMRST= Y | N

Specifies whether the z/OS® Automatic Restart Manager (ARM) should be used to restart the SCI address space after an abend. Y (yes) specifies that ARM should be used. The SCI address space is restarted by ARM after most system failures. N (no) specifies that ARM should not be used. The SCI address space is not restarted by ARM after any failures. For more information about ARM, see The z/OS Automatic Restart Manager (ARM) in IMS Version 15.5 System Administration.

IMSPLEX()

Specifies definitions for an IMSplex managed by SCI. IMSPLEX is a required parameter. There is no default. Only one IMSPLEX keyword can be specified. The IMSPLEX keyword must precede the left parenthesis. The IMSPLEX definition parameters follow:

NAME=

Specifies a 1- to 5-character name that specifies the IMSplex group name. SCI concatenates this name to CSL to create the IMSplex group name. All OM, RM, SCI, IMS, and other address spaces that are in the same IMSplex must specify the same name. This is done by specifying the same name for the IMSPLEX= parameter in the CSLOIxxx, CSLRIxxx, CSLSIxxx, and DFSCGxxx members of the IMS PROCLIB data set.

SCINAME=scimbrname

Specifies the name for the SCI address space. This is an optional 1-6 character name. You must specify this parameter either as an execution parameter or in the CSLSIxxx member of the IMS PROCLIB data set. This name is used to create the SCIID which is used in SCI processing. The 8-character SCIID is the SCINAME followed by the characters SC. Trailing blanks in the SCINAME are deleted and the SCIID is padded with blanks. For example, if SCINAME=ABC then SCIID=ABCSC .

FORCE=()

Specifies that SCI is to clean up the global interface storage. FORCE is an optional parameter and has no default. The keywords are:

ALL

SCI should delete all the global storage, including control blocks and routines. This keyword is required.

SHUTDOWN

SCI should shut down after cleaning the global storage. This keyword is optional.

No local IMSplex members can be active when the FORCE keyword is used. If a member is active, results are unpredictable. Use the FORCE keyword in the following situations:

• When an IMSplex managed by an SCI on one image is managed by a different SCI. For example, PLEX1 is managed by SCI1. If SCI1 becomes inactive, PLEX1 is managed by SCI2. Before SCI2 is started, use FORCE(ALL,SHUTDOWN) on SCI1 to clean the global storage.
• When an SCI is not reactivated on an image. To clean the global storage, reactive that SCI one final time using the FORCE(ALL, SHUTDOWN) keyword.