Print Member Syntax

Processing Element Actions › The Print Statement › The Print Member Statement › Print Member Syntax

Print Member Syntax

►►─ PRInt MEMber ─ member-name ─┬─────────────────────────────┬───────────────►
                                └─┬─ THRough ─┬─ member-name ─┘
                                  └─ THRu ────┘
►─ FROm ─┬─┬─ FILe ───┬─ dd-name ──┬──────────────────────────────────────────◄
         │ └─ DDName ─┘            │      
         └─ DSName ─ dataset-name ─┘      
 ►─ TO ─┬─ C1PRINT ◄ ────────────┬─┬──────────────────────────────┬───────────►
        ├─ C1PRTVB ──────────────┤ └─ WHEre ─ ¤ ─┬──────────┬─ ¤ ─┘
        └─┬─ FILe ───┬─ dd-name ─┘               ├─┤ CCID ├─┤
          └─ DDName ─┘                           └─┤ PRO ├──┘

PRINT MEMBER member-name

Indicates the name of the member(s) to be printed. You can use a name mask.

THROUGH (THRU) member-name

Indicates that a range of members should be printed beginning with the member coded in the PRINT MEMBER statement, up to and including the member specified in this statement. You can use a name mask with either name.

FROM FILE (DDNAME) dd-name
DSNAME dataset-name

The FROM clause indicates the location of the member being printed. CA Endevor SCM uses both the FROM clause in an action and any preceding SET FROM clause to determine the "from" criteria for that action.

A FROM clause in an action overrides values in a SET FROM clause that precedes the action.
If the SET FROM clause contains values that are not included in the FROM clause, CA Endevor SCM uses these values.

You must enter a FILE, DDNAME, or DSNAME (enter one and only one); be sure the appropriate JCL is coded for a FILE or DDNAME. If you enter any other information in the FROM clause, it is ignored.

TO C1PRINT | C1PRTVB | FILE dd-name | DDNAME dd-name

The TO clause indicates where the element prints.

A TO clause in an action overrides values in a SET TO clause that precedes the action. For more information about the SET TO statement, see Set To Syntax."
If you do not enter any information in the TO clause for the PRINT action, any preceding SET TO statement information is used.
If the SET TO clause contains values that are not included in the TO clause, CA Endevor SCM uses these values.
If you do not enter any information in the TO clause for the PRINT action, and if a SET TO clause has not been entered, the system defaults to C1PRINT.

C1PRINT

Prints to an internal print queue or file. C1PRINT requires the appropriate JCL. If you print an element with records that are longer than 121 characters, then the use of C1PRINT can lead to truncation of the output. To avoid this, use the C1PRTVB ddname. Examples follow:

To send your output to the queue, code the following. This is the default:
```
//C1PRINT DD SYSOUT=*
```
To send your output to an existing file, code the following:
```
//C1PRINT DD DISP=SHR,DSN=filename
```

C1PRTVB

Prints elements that have records that are longer than 121 characters to an internal print queue or file. You must have previously allocated the C1PRTVB data set appropriately. The recommended DCB for C1PRTVB is LRECL=27994,BLKSIZE=0,RECFM=VB. However, if the record size of any record is longer than 27978, code a larger record length. You must code a sufficiently long LRECL for the output file. The LRECL size should be at least 16 bytes longer than the longest record of the element. For example, allocate the data set as follows:

//C1PRTVB  DD DISP=(,CATLG),DSN=my.C1PRTVB,
//         SPACE=TRK,(5,5),UNIT=SYSDA, 
//         DCB=(RECFM=VB,LRECL=27994,BLKSIZE=0)

FILE dd-name | DDNAME dd-name

Prints to a location external to CA Endevor SCM (for example, a library, sequential file, or PDS). When you enter a file name or DDname, be sure that the appropriate JCL is coded. For the ddname value, you can specify a sequential file with a mandatory fixed record format and an LRECL of 133. If these specifications are not defined, the PRINT action fails. If you print an element with records that are longer than 121 characters, then the use of this data set can lead to truncation of the output. To avoid this, use the C1PRTVB ddname.

Example: Print SCL

In the first example, the SCL prints the current version of element "PAYRPT19." The output is written to the default DDname (C1PRINT).

PRINT ELEMENT 'PAYRPT19'

    FROM ENVIRONMENT 'PROD'
	         SYSTEM 'PAYROLL'
		 SUBSYSTEM 'REPORTS'
		 TYPE 'COBOL'
	 	 STAGE NUMBER 1 .

The SCL in the second example prints member "PAYRPT12" from the CA Endevor SCM Listing Library. The output is sent to the default Ddname (C1PRINT).

PRINT MEMBER 'PAYRPT12'
	FROM DSNAME 'ENDEVOR.PAYROLL.STAGE1.LISTINGS' .