Creating input to the extract routine EYU9BCSD
About this task
The input file for the CICSPlex SM extract routine EYU9BCSD consists of a series of control statements. These control statements describe the CSD records you want to extract and the resource groups with which they should be associated.
- The file must have a fixed logical record length of 80.
- Each control statement must be contained on a single line.
- Any line with * in column 1 is treated as a comment.
- RESGROUP(CSDGROUP|resgroup)
- Identifies the resource group or groups to be generated:
- CSDGROUP
- A RESGROUP definition is generated for each CSD group presented to EYU9BCSD.
- resgroup
- A single RESGROUP definition is generated using the specified name.
- RESINGRP(CSDGROUP|resgroup)
- Identifies the resource group with which resource definitions
are to be associated:
- CSDGROUP
- Resource definitions are associated with a resource group having the same name as the original CSD group.
- resgroup
- Resource definitions are associated with the specified resource group. The resource group must already be defined in the data repository for an association to be created.
- objtype(resname)
- Identifies the CSD records to be processed by EYU9BCSD, where:
- objtype
- Is the CSD resource type, which may be one of the following:
ATOMSERVICE, BUNDLE, CONNECTION, CORBASERVER, DB2CONN, DB2ENTRY, DB2TRAN, DJAR, DOCTEMPLATE, ENQMODEL, FILE, JOURNAL, IPCONN, JOURNALMODEL, LIBRARY, LSRPOOL, MAPSET, MQCONN, PARTITIONSET, PARTNER, PIPELINE, PROCESSTYPE, PROFILE, PROGRAM, REQUESTMODEL, SESSIONS, TCPIPSERVICE, TDQUEUE, TERMINAL, TRANCLASS, TRANSACTION, TSMODEL, TYPETERM, URIMAP, WEBSERVICE
You can specify multiple objtype statements in a single input file, but each one must represent a different resource type. Only one objtype statement of a given resource type is allowed per input file.
- resname
- Is the specific or generic name of a CSD resource of the specified
type.
For example, PROGRAM(*) would process all the PROGRAM records in the CSD presented to EYU9BCSD. PROGRAM(AB+C*) would process only those PROGRAM records that match the generic pattern. Note that the asterisk (*) is interpreted according to CICSPlex SM rules for generics, not CEDA rules.
- 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 CSD 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 EYU9BCSD 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 EYU9BCSD output can be used only with the CICSPlex SM batched repository-update facility at CICSPlex SM and later. The EYU9BCSD 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 ResourceIf you specify INQUOTES(NO), which is the default, the EXTRACT routine will produce the following statement in the output data set:DESCRIPTION(1) Describe Resource)The CICSPlex SM batched repository-update facility interprets this as a DESCRIPTION field containing the value 1, followed by two unrecognizable keywords.
If you specify INQUOTES(YES), EYU9BCSD places quotes around the field value. The output data set would contain the statement:DESCRIPTION('1) Describe Resource')This statement is interpreted correctly by the CICSPlex SM batched repository-update facility.