Configuring and Installing Optional Components › Configuration Tasks for Optional Base Components › Direct Generic Data Set Output › Define a Generic Data Set

Define a Generic Data Set

To establish a generic data set interface with CA OPS/MVS, specify JCL that identifies CA OPS/MVS as a target for the output. Specify this JCL as follows:

//ddname DD SUBSYS =(ssid,OPSDSN{,color}{,reportid}{,posmgid})

ddname

The ddname associated with the file.

ssid

The four-character CA OPS/MVS subsystem ID that receives generic interface messages (usually OPSS).

color

(Optional) Specifies the color in which generic data set messages appear in OPSLOG.

Valid values: GREEN, BLUE, RED, WHITE, PINK, YELLOW, or TURQ

reportid

(Optional) Specifies a unique report ID that an AOF rule can use to identify the source of the message.

posmsgid

(Optional) Specifies either of the following:

• The numeric starting position in the text of each record at which CA OPS/MVS is to begin its scan for a message ID.
• A character string that is to be used as the message ID for all the records in this data set.

When the numeric starting position is longer than any particular record in the file, the message ID scan starts at the beginning of that record.

Example 1: Send Messages to Subsystem OPSS

• Messages are blue in the OPSLOG
• MSG.COLOR is blue
• The report ID is PERFRPT
• The AOF starts scanning for the MSGID in the first column of each record.

  //DD1     DD    SUBSYS=(OPSS,OPSDSN,BLUE,PERFRPT)
  

Example 2: Send Messages to Subsystem OPST

• Messages are pink in the OPSLOG
• MSG.COLOR is pink
• The report ID is ESPLOG
• All messages from this data set have a MSGID of ESPMSG.

Note: This message ID is not inserted into the message.

//DD2   DD  SUBSYS=(OPST,OPSDSN,PINK,ESPLOG,ESPMSG)

Example 3: Send Messages to Subsystem OPSS

• Messages are red in the OPSLOG
• MSG.COLOR is red
• The report ID is MYLOG
• The AOF starts scanning for the MSGID in column 22 of each record.

Note: This technique is useful for log files that either have a fixed length, time stamp, or both at the beginning of each record, or some other fixed length prefix followed by the message ID.

//DD3   DD  SUBSYS=(OPSS,OPSDSN,RED,MYLOG,22)