PARM parameters

QMGRname

Specifies the 1- to 4- character name of the queue manager or queue-sharing group to which CSQUTIL is to connect.

If you specify the name of a queue-sharing group, CSQUTIL connects to any queue manager in that group

QSGname

Specifies the 1- to 4- character name of the queue-sharing group from which CSQUTIL is to extract definitions.

DSGname

Specifies the 8-character name of the DB2 data-sharing group from which CSQUTIL is to extract definitions.

DB2ssid

Specifies the 4-character name, or group attach name, of the DB2 database subsystem to which CSQUTIL is to attach for stand-alone functions.

 

Which PARM parameters do we need?

Figure 51 shows that we can specify one of four options on the PARM statement. The option you specify depends on the function we need to implement, as follows:

• Use

  PARM= (or omit it all together) if you are using only offline functions, and not QSGDISP(GROUP) or QSGDISP(SHARED).

• Use

  PARM='QMGRname' only if you intend to use functions that require the queue manager to be running, such as COPY and COMMAND.

• Use

  PARM='QSGname,DSGname,DB2ssid' if you intend to use the SDEFS function with either QSGDISP(GROUP) or QSGDISP(SHARED) specified. This is because CSQUTIL requires access to DB2 to perform the SDEFS function in this situation.

• Use

  PARM='QMGRname,QSGname,DSGname,DB2ssid' if you intend to combine the previous two functions in one CSQUTIL job.

If you specify a queue manager name as blanks, CSQUTIL uses the name of the default queue manager specified for z/OS batch programs in CSQBDEFV. The utility then uses this queue manager for the whole job step. When the utility connects to the queue manager, the authorization of the "signed-on user name" is checked to see which functions the invocation is allowed to use.

You specify the functions required by statements in the SYSIN data set according to these rules:

• The data set must have a record length of 80.

• Only columns 1 through 72 are significant. Columns 73 through 80 are ignored.

• Records with an asterisk (

  *) in column 1 are interpreted as comments and are ignored.

• Blank records are ignored.

• Each statement must start on a new line.

• A trailing - means continue from column 1 of the next record.

• A trailing + means continue from the first non-blank column of the next record.

• The keywords of statements are not case-sensitive. However, some arguments, such as queue name, are case-sensitive.

The utility statements refer to the default or explicitly named DDnames for input and output. Your job can use the COPY and LOAD functions repeatedly and process different page sets or queues during a single run of the utility.

All output messages are sent to the SYSPRINT data set, which must have a record format of VBA and a record length of 125.

While running, CSQUTIL uses temporary dynamic queues with names of the form SYSTEM.CSQUTIL.*