Creating a data set for re-input to the batched repository-update facility

You can create an output data set from the batched repository-update facility to hold the CREATE statements produced from DUMP commands. This data set is in the correct format for re-input to the batched repository-update facility without further editing; that is, it does not contain heading lines and the data is aligned in the correct columns. Note, however, that you may still need to edit this output data to modify the context, group names, version numbers, and so on.

When you use the DUMP command (see Creating and maintaining CICSPlex SM definitions), you may use the OUTPUT command to request that any resulting CREATE commands are written to an output data set, in addition to the normal report. The OUTPUT command must be the first command in the BATCHREP input data stream, to ensure that the command precedes any DUMP commands. You cannot specify more than one OUTPUT command.

Note:
Start of change
If a partitioned data set is used as the output data set, you must ensure that the data set has enough space to handle the output. A full partitioned data set without sufficient directory space may cause multiple abends resulting in the termination of the CMAS. To avoid multiple abends during CICS recovery, direct output to a sequential data set. If required, you can then copy the sequential data set output to a partitioned data set.
End of change

The format of the OUTPUT command is:

  OUTPUT DATASET DSNAME(data.set.name(member)) INQUOTES(NO|YES);

where:

DATASET
This keyword must be specified.
DSNAME
Specifies a data set name. You must specify a data set name and the data set must exist. The output data set cannot be the same as the input data set. The data set must consist of fixed-length, 80-byte records; the records may be blocked and any block size is acceptable.
data.set.name
The data set name must not exceed 44 characters in length. Each component of the name cannot be more than 8 characters long, and the components must be separated by full stops. The data set name must be a fully-qualified data set name. The first component of the data set name does not default to the logged-on user id.
Start of changememberEnd of change
Start of changeThe member name, if the output data set is partitioned. The member name cannot be more than 8 characters long. The member name must be omitted if the output data set is not partitioned.End of change
INQUOTES(NO|YES)
Identifies whether or not you want field values enclosed in quotes on the output data set. You may need to use this control statement if you have any data on your Start of changedata repositoryEnd of change that contains unbalanced parentheses. If you omit this keyword, the default value of NO is assumed.
NO
The values of parameters are not enclosed in quotes on the output data set. This setting is perfectly adequate for input to the batched repository-update facility, but you might encounter problems if the parameter values contain unbalanced parentheses.

Note that, if you specify INQUOTES(NO), the BATCHREP output can be used as input to any release of the CICSPlex® SM batched repository-update facility.

YES
All values of parameters are enclosed in quotes on the output data set. The CICSPlex SM batched repository-update facility terminates the parameter value at the final quote, not at an embedded parenthesis.

Note that, if you specify INQUOTES(YES), the BATCHREP output can be used only with the CICSPlex SM batched repository-update facility at CICS® Transaction Server for OS/390®, Version 1 Release 3 and later. The BATCHREP output is not compatible with, and cannot be used as input to, the batched repository-update facility supplied with earlier releases of CICSPlex SM.

For example, suppose a DESCRIPTION field contains the value:

 1) Describe Resource

Start of changeIf you specify INQUOTES(NO), which is the default, the DUMP routine will produce the following statement in the output data set:

 DESCRIPTION(1) Describe Resource)
End of change

The CICSPlex SM batched repository-update facility interprets this as a DESCRIPTION field containing the value 1, followed by two unrecognizable keywords.

Start of changeIf you specify INQUOTES(YES), the DUMP routine places quotes around the field value. The output data set would contain the statement:

 DESCRIPTION('1) Describe Resource')
End of change

This statement is interpreted correctly by the CICSPlex SM batched repository-update facility.

[[ Contents Previous Page | Next Page Index ]]