USERSUBSYSTEM

Use the USERSUBSYSTEM command to assign a subsystem name to an address space with a particular job name or program name that is executing in the address space.

UIE recognizes a number of subsystem address spaces (CICS, CICSUTL, DB2, DB2UTL, IMS, IMSUTL, IRLM, OMVS, MQ, WAS) by matching the program names that are reported in the type 30 record to a hard-coded list of program names. Use USERSUBSYSTEM to associate other program names to existing subsystems or define your own subsystem names for programs or job names.

Syntax

USERSUBSYSTEM <subsystemname>
  SID=<comma-separated system ID list>
  PGM=<program name or pattern>
  JOB=<jobname or pattern>
  SCL=<comma-separated service class name list>
  RCL=<comma-separated report class name list>

Syntax explanations

< subsystemname> is a one- to eight-character name to be assigned to this subsystem.
SID is a comma-separated list of system IDs.
PGM is a one- to eight-character program name or pattern.
JOB is a one- to eight-character job name or pattern.
SCL is a comma-separated list of service class names.
RCL is a comma-separated list of report class names.

Rules

A subsystem name must be specified. The PGM or JOB parameter is required. All other parameters are optional.
A pattern can be a combination of the wildcard character *, the wildcard character ?, and standard EBCDIC characters. An * denotes 0 or more characters preceding or following a character string. A ? denotes that any character can appear in this position within the string. The pattern cannot exceed the field length of the element. A maximum of three * are allowed per pattern. Some valid patterns for an 8-byte element could be:
AB*
*AB
*AB*
*A*B
*A*B*
????????
??*ABC
*A??B*

Note

The USERSUBSYSTEM command overrides the default UIE algorithm of assigning the subsystem name. It means, for example, that if you specify the job name of a CICS region in the JOB parameter, this region will be assigned a subsystem name from the USERSUBSYSTEM command instead of the UIE default subsystem name 'CICS'.

Examples

USERSUBSYSTEM SORT PGM=DFSORT
USERSUBSYSTEM SORT PGM=SYNCSORT
USERSUBSYSTEM SORT PGM=SORT

In this example, UIE will assign a subsystem type of SORT to the program names DFSORT, SYNCSORT, and SORT.