Processing Element Actions › The 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 ─ ¤ ─┬─────────────────────────────────┬─ ¤ ─┘
                   ├─ COMPonent ─┬─ BROwse ◄ ─┬──────┤
                   │             ├─ CHAnge ───┤      │
                   │             ├─ HIStory ──┤      │
                   │             └─ SUMmary ──┘      │
                   ├─┬─────────────┬─┬─ BROwse ◄ ──┬─┤
                   │ └─ ELEment ◄ ─┘ ├─ CHAnge ────┤ │
                   │                 ├─ HIStory ───┤ │
                   │                 ├─ SUMmary ───┤ │
                   │                 ├─ MASter ────┤ │
                   │                 └─┤ LISTING ├─┘ │
                   ├─ 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.

COMPONENTS

When you select this option, CA Endevor SCM prints all component information for the element specified. The CA Endevor SCM Automated Configuration option is required to use the COMPONENTS keyword.You can specify one,but only one, of the following options in the COMPONENTs clause: BROWSE, CHANGES, HISTORY, SUMMARY, or MASTER.

Note: To print information for the element specified, but not the related components, you can specify one of these options, without the COMPONENTS keyword: BROWSE, CHANGES, HISTORY, SUMMARY, or MASTER.

• BROWSE-When you select the BROWSE option, CA Endevor SCM 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.
• CHANGES-When you select the CHANGES option, CA Endevor SCM 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-When you select the HISTORY option, CA Endevor SCM 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-When you select the SUMMARY option, CA Endevor SCM 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-When you select the MASTER option, CA Endevor SCM prints Master Control File information stored for the selected element or component, as well as current data pertaining to that element or component (such as last processor, processor return codes, current version or level, and so on.)

The BROWSE, CHANGES, HISTORY, SUMMARY, and MASTER printouts provide the same information as their corresponding online panels. See the User's Guide for additional details.

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.

If you code only COMPONENTS, CA Endevor SCM prints BROWSE information. If you code COMPONENTS in conjunction with the BROWSE, CHANGES, HISTORY, and SUMMARY options, CA Endevor SCM prints the requested information for the element component list. If you code COMPONENTS in conjunction with the MASTER option, CA Endevor SCM prints both COMPONENTS and MASTER information.

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. The COMPONENTS option applies only to section would not appear in the associated listing. The COMPONENTS option applies only to CA Endevor SCM ACM. If you are not a CA Endevor SCM ACM user and you code this option, the action fails.

LISTING

When you select the LISTING option, the element's associated output listing is printed. The CA Endevor SCM Automated Configuration Option is required. 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.

The default value for the LISTING option is LIST, but you can override the default by specifying a text string (of up to eight characters) using the keyword COMPONENT LIST TEXT STRING on the LISTING clause, or by changing the C1DEFLTS parameter COMPLISTWD=, which defines the site-wide component listing string ID. 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

COMPONENTS

BROWSE

CHANGE

HISTORY

SUMMARY

MASTER

Coding NOCC results in a syntax error. 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

When you select the EXPLODE option, CA Endevor SCM prints the input component information extracted from the ACMQ files (ACMROOT and ACMXREF), for the specified element.