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

Print Element Syntax

►►─ PRInt ELEment ─ element-name ─┬──────────────────────────────┬────────────►
                                  └─┬─ THRough ─┬─ element-name ─┘
                                    └─ THRu ────┘

 ►─┬─────────────────────┬─┬─────────────────┬─ FROm ─────────────────────────►
   └─ VERsion ─ version ─┘ └─ LEVel ─ level ─┘

 ►─ ENVironment ─ env-name ─ SYStem ─ sys-name ─ SUBsystem ─ subsys-name ─────►

 ►─ TYPe ─ type-name ─ STAge NUMber ─ stage-no ───────────────────────────────►

 ►─ TO ─┬─ C1PRINT ◄ ────────────┬─┬──────────────────────────────┬───────────►
        ├─ C1PRTVB ──────────────┤ └─ WHEre ─ ¤ ─┬──────────┬─ ¤ ─┘
        └─┬─ FILe ───┬─ dd-name ─┘               ├─┤ CCID ├─┤
          └─ DDName ─┘                           └─┤ PRO ├──┘

 ►─┬───────────────────────────────────────────────────────────┬─ . ───────────►◄
   └─ OPTions ─ ¤ ─┬─────────────────────────────────────┬─ ¤ ─┘
                   ├─┬─ ELEment ◄ ─┬──┬─ BROwse ◄ ─┬─────┤
                   │ └─ COMPonents ┘  ├─ CHAnge ───┤     │
                   │                  ├─ HIStory ──┤     │
                   │                  ├─ SUMmary ──┤     │
                   │                  └─ MASter ───┘     │
                   ├─┬─────────────┬───┤ LISTING ├───────┤
                   │ └─ ELEment ◄ ─┘                     │
                   ├─ EXPLODE ───────────────────────────┤
                   ├─ NOCc ──────────────────────────────┤
                   └─┬─ NOSearch ◄ ─┬────────────────────┘
                     └─ SEArch ─────┘                

Expansion of CCID

├── CCId ─┬──────────────────────┬─┬───────────┬─ ( ─ ccid ─ ) ────────────────┤
          └─ OF ─┬─ CURrent ◄ ─┬─┘ ├─ EQual ◄ ─┤
                 ├─ ALL ───────┤   └─ = ───────┘
                 └─ RETrieve ──┘

Expansion of PRO

├── PROcessor GROup ─┬─ EQ ─┬─ ( ─ group name ─ ) ─────────────────────────────┤
                     └─ = ──┘

Expansion of LISTING

├── LISTING ─┬────────────────────────────────────────────┬────────────────────┤
             └─ COMPONENT LIST TEXT STRING ─ text-string ─┘

PRINT ELEMENT element-name

Indicates the up to ten character name of the elements to be printed. You can use a name-mask, unless you specify a level (in the LEVEL clause).

THROUGH (THRU) element-name

Indicates that a range of elements should be printed, beginning with the element coded in the PRINT ELEMENT statement, up to and including the element specified in this statement. You can use a name-mask with either name. If you enter a THROUGH clause, you cannot enter a LEVEL clause.

VERSION version LEVEL level

Indicates the version and level number you want to print. You must code a full element name if you want to indicate a version level. Acceptable version numbers are 1-99. Acceptable level numbers are 00-99. By default, information for the current version level is printed. VERSION and LEVEL must be specified together. If you enter this clause, you cannot use the THROUGH clause.

FROM ENVIRONMENT env-name

SYSTEM sys-name

SUBSYSTEM subsys-name

TYPE type-name

STAGE stage-no

The FROM clause indicates the location of the element 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.

Note: For more information about the SET FROM statement, see the chapter "Using Set, Clear, and EOF Statements."

You must specify an environment, system, subsystem, type, and stage number (either 1 or 2). The environment name must be explicit. You can use a name-mask with the system, subsystem, type, and stage number.

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.

WHERE

Use WHERE clauses to further qualify element selection criteria. CA Endevor SCM uses both the WHERE clause in an action and any preceding SET WHERE clause to determine the “where” criteria for that action.

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

Note: For more information about the SET WHERE statement, see the chapter "Using Set, Clear, and EOF Statements."

WHERE CCID OF ccid

Limits the processing to those elements that match one of the supplied CCIDs. You can use a name-mask in this field.

• CURRENT-Tells CA Endevor SCM to look through the CCID fields in the MCF (Master Control File) to find a specified CCID(s). This is the default.
• ALL-Tells CA Endevor SCM to search both the Master Control File and the SOURCE DELTA levels for a specified CCID(s). If you have ACM, CA Endevor SCM also searches the COMPONENT LIST DELTA levels for the specified CCID(s). If the element is sourceless , the source element delta level CCID checks are not done, because the element source and delta files are not present.
• RETRIEVE-Tells CA Endevor SCM to use the CCID in the Master Control File's RETRIEVE CCID field. If you need to select elements identified under more than one CCID, you can specify multiple CCIDs by enclosing the CCIDs with parentheses and separating them with commas. The CCIDs may extend over multiple lines if necessary.

The following example illustrate the use of this clause:

Example  1: WHERE CCID OF CURRENT (PROJ001, PROJ002, PROJ004)
Example 2: WHERE CCID OF ALL (PROJ00V)

WHERE PROCESSOR GROUP group name

This clause allows you to select elements according to a specified processor group. You can use a name-mask when specifying the processor group name.

If you need to select elements identified under more than one processor group, you can specify multiple distinct processor group selectors by enclosing the processor groups with parentheses and separating them with commas. The processor groups may extend over multiple lines if and separating them with commas. The processor groups may extend over multiple lines if necessary.

The next examples illustrate the use of this clause:

Example 1: WHERE PROCESSOR GROUP (COBVS, COBII)
Example 2: WHERE PROCESSOR GROUP (COBV

OPTIONS

OPTIONS clauses allow you to further specify an action request.

NOCC

Suppresses the default printing of a header on each page of output. For the PRINT ELEMENT MASTER output, other line feed characters in column 1 of the output are replaced with a blank space.

ELEMENT | COMPONENTS BROWSE | CHANGES | HISTORY | SUMMARY | MASTER

Prints element or component information.

ELEMENT

Prints all information for the specified element, but not its related components. The default.

COMPONENTS

Prints all component information for the specified element. The CA Endevor SCM Automated Configuration option is required to use the COMPONENTS keyword.

CA Endevor SCM prints as much information as is available for the component list. For example, if you code COMPONENTS CHANGES but there were no changes to the output components section, that section would not appear in the associated listing.

You can specify one, but only one, of the following options in the clause. BROWSE is the default.

• BROWSE— Prints the current element or component list source, indicating the level at which each line was added. If you specify a particular level, CA Endevor SCM prints the source for that level. The Default.
• CHANGES— Prints all the changes-inserts and deletes-made to the element or component list at the level specified. If you do not specify a level in the LEVEL clause, changes for the current level of the element are shown.
• HISTORY— Prints all lines that have ever been in the element or component list source, noting the level at which the line was added, changed, or deleted. If you specify a level in the LEVEL clause, CA Endevor SCM prints history for that level.
• SUMMARY— Prints a summary line of data for each level of the element or component list specified, and includes information appropriate to that level (for example, the number of inserts and the number of deletes).
• MASTER— Prints Master Control File information stored for the selected element, as well as the BROWSE data, which is the current data pertaining to that element or component (such as last processor, processor return codes, current version or level, and so on.) If you code COMPONENTS with the MASTER option, CA Endevor SCM prints the element MASTER information and the component BROWSE data.

The BROWSE, CHANGES, HISTORY, SUMMARY, and MASTER printouts provide the same information as their corresponding online panels. For information about the online panels, see the User's Guide.

The element BROWSE, CHANGE, HISTORY and SUMMARY options are not supported on sourceless elements. When encountered, the action is skipped and an information message is written to the action log. The MASTER option is supported for both sourced and sourceless elements.

ELEMENT LISTING COMPONENT LIST TEXT STRING text-string

Prints the element's associated output listing. The CA Endevor SCM Automated Configuration Option is required. Specifying the keyword ELEMENT is optional. The default value for the LISTING option is LIST. If you want to use the default value, then do not specify COMPONENT LIST TEXT STRING text-string. You can override the default by specifying a text string using the keyword COMPONENT LIST TEXT STRING, or by changing the C1DEFLTS parameter COMPLISTWD=, which defines the site-wide component listing string ID.

COMPONENT LIST TEXT STRING text-string

Specifies the one- to eight-character text-string used to identify the listing data set to print.

To identify the output listing file to be printed, the LISTING option's value is matched against the contents of all the component output data sets. To find the output listing library, all component output data sets are searched for a particular string. The first one found containing this string becomes the targeted listing data set. All component output data sets are searched for a match in the following order:

• The text-string you specify with the COMPONENT LIST TEXT STRING keyword. If you did not use this option, or the string is not found, then
• The COMPLISTWD= parameter in the C1DEFLTS table. The default value for this parameter is LIST. The default value can be changed on the C1DEFLTS table. You can also change the text string by changing the value for the LISTING DATASET STRING on the User Default panel.

If you code the LISTING option, you should not code the following options:

NOCC— Coding NOCC results in a syntax error.

COMPONENTS

BROWSE

CHANGE

HISTORY

SUMMARY

MASTER

If you code multiple display options (browse, change, history, summary), then the last one coded is returned.

SEARCH or NOSEARCH

The SEARCH option tells CA Endevor SCM to look and print all occurrences of the element on the map.

The default is NOSEARCH. Code NOSEARCH to restrict CA Endevor SCM's search to the current environment.

EXPLODE

Prints the input component information extracted from the ACMQ files (ACMROOT and ACMXREF), for the specified element.

When Explode is specified, the print action for the element jumps to the top of the list to be executed. Therefore, any Print actions that use the Explode option are processed first before other actions are processed in Type sequence order.