Creating input to the extract routine EYU9BCSD

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 input file must adhere to the following requirements:

The following control statements are supported:

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.
The RESGROUP statement is optional and, if specified, only one is allowed per input file.
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.
The RESINGRP statement is optional and, if specified, only one is allowed per input file. If you do not specify a RESINGRP statement, the batched repository-update facility CREATE xxxxDEF command is generated without a RESGROUP operand. In that case, the xxxxDEF resource definition is not automatically associated with any resource group.
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:

CONNECTION,CORBASERVER, DB2CONN, DB2ENTRY, DB2TRAN, DJAR, DOCTEMPLATE, ENQMODEL, FILE, JOURNAL, JOURNALMODEL, LSRPOOL, MAPSET, PARTITIONSET, PARTNER, PROCESSTYPE, PROFILE, PROGRAM, REQUESTMODEL, SESSIONS, TCPIPSERVICE, TDQUEUE, TERMINAL, TRANCLASS, TRANSACTION, TSMODEL, TYPETERM

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 CICS® Transaction Server for OS/390®, Version 1 Release 3 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 Resource

If 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.

Related concepts
The CICSPlex SM-supplied extract routine
Output from EYU9BCSD
CICS Operations and Utilities Guide
CICS Operations and Utilities Guide
Related tasks
Submitting a job to EYU9BCSD
Editing the EYUOUT file
Submitting EYUOUT to the batched repository-update facility
Related reference
CICS Operations and Utilities Guide
CICS Operations and Utilities Guide
CICS Operations and Utilities Guide
CICS Operations and Utilities Guide
[[ Contents Previous Page | Next Page Index ]]