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(R) 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 you need?
Figure 51 shows that you can specify one of four options on
the PARM statement. The option you specify depends on the function you 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.*