Skip to Content

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.

Related topic

Command-and-syntax-reference

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*
Warning

Important

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.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

Universal Information Exchange 2.2