CSLOIxxx member of the IMS PROCLIB data set

Some parameters within CSLOIxxx can be overridden with the OM execution parameters.

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

Syntax

Usage

/* PROCLIB comments */

BPE considerations

Use the OM BPE user exit list member of the IMS PROCLIB data set to define OM user exits to BPE. This is the member of the IMS PROCLIB data set 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 OM BPE user exit list member of the IMS PROCLIB data set is shown in Sample OM user exit list member of the IMS PROCLIB data set.

A sample CSLOIxxx member of the IMS PROCLIB data set is shown in Sample CSLOIxxx member of the IMS PROCLIB data set. The sample, called CSLOI000, is provided as part of the IMS PROCLIB data set.

Parameters

ARMRST= Y | N

An optional keyword that you use to specify whether the z/OS® Automatic Restart Manager (ARM) is to be used to restart the OM address space after an abend. If you specify Y (yes), ARM restarts the OM address space after most system failures. If you specify N (no), ARM does not restart the OM address space after any system failure.

ARM does not restart the OM address space if OM ends abnormally before restart is complete.

CMDLANG=

An optional keyword that you use to specify the language to be used for IMS command text that is distributed to OM automation clients upon request. This affects only the command descriptions that are displayed on a workstation SPOC that requests command text from OM. This value defaults to ENU for US English.

The value is not validated at OM initialization time. It is only validated when a CSLOMQRY QUERY TYPE(CMDSYNTAX) request is issued. OM attempts to read a PDS member in the data set specified by the CMDTEXTDSN= with a member name of CSLOT concatenated with the 3-character CMDLANG= value. This is the member that contains the command syntax translatable text. The CMDLANG= value can be overridden on the CSLOMQRY request.

This parameter can be specified as an execution parameter on the OM procedure to override the value in CSLOIxxx.

The possible values for this parameter are:

CHS

Simplified Chinese

CHT

Traditional Chinese

DAN

Danish

DEU

German

ENU

English

FIN

Finnish

FRA

French

ITA

Italian

JPN

Japanese

KOR

Korean

NOR

Norwegian

POL

Polish

POR

Portuguese

RUS

Russian

SPA

Spanish

SWE

Swedish

CMDSEC=

An optional keyword that you use to specify the security method to be used for OM command security.

A

Specifies that both RACF® (or an equivalent security product) and the exit are to be called (options E and R). RACF is called first. Then the security authorization facility (SAF) return code, RACF return code, and RACF reason code are passed to the exit. These return codes are decoded into a security code, which is also passed to the exit for processing.

E

Specifies that the OM Security user exit routine is to be called for command authorization.

N

Specifies that no authorization checking is to be done. This is the default.

R

Specifies that RACF (or an equivalent security product) is to be called for command authorization.

CMDTEXTDSN=

Specifies the data set name for the PDS that contains the command syntax translatable text. This keyword is required. The parameter value is the 1-44 character data set name. The data set must be a PDS with fixed-length record members.

If you specified, for example, CMDTEXTDSN=IMSBLD.IMS11R.SDFSDATA and CMDLANG=SPA (for Spanish language command text), the text would be located in PDS member IMSBLD.IMS11R.SDFSDATA(CSLOTSPA).

IMSPLEX()

Specifies definitions for an IMSplex managed by OM. 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-5 character identifier that specifies the IMSplex group name. OM concatenates this identifier to CSL to create the IMSplex group name. All IMSplex member address spaces that are in the same IMSplex group sharing either databases or message queues must specify the same identifier. The same identifier must also be used for the IMSPLEX= parameter in the CSLSIxxx, CSLRIxxx, and DFSCGxxx members of the IMS PROCLIB data set.

AUDITLOG=

An optional 1- to 26-character name of the z/OS log stream to which OM writes input and output information about commands, command responses, and unsolicited messages. The information in this log stream tells you where commands originate, what the command processed, and the result of that processing. You cannot issue this parameter as an OM execution parameter.

The audit trail log stream SYSLOG.OM2Q01.LOG is defined as part of the IVP and is then associated with the AUDITLOG= parameter of the IVP sample job.

In the following scenarios, no data is lost in the OM audit trail when the log stream becomes available because OM logs its work:

• If the connection to the log stream fails at startup, the initialization continues. Connection is set up after the log stream becomes available.
• If writing to the log stream fails for OM, OM waits for the log stream to become available and performs the writing process again.

Requirement: The following SAF security rules must be defined to support the use of the OM audit trail:

• The OM address space has FAC (facility) access to the structure.
• The OM address space has access to the log stream. This access can be accomplished using an SAF rule.
• Any user reading the log stream must have SAF read access.

OMNAME=ommbrname

Specifies the name for the OM address space. This is an optional 1-6 character name. Specify this parameter either as an execution parameter or in the CSLOIxxx member of the IMS PROCLIB data set. This name is used to create the OMID which is used in OM processing. The 8-character OMID is the OMNAME followed by the characters "OM". Trailing blanks in the OMNAME are deleted and the OMID is padded with blanks. For example, if OMNAME=ABC then OMID="ABCOM   ".