SCRT JCL: What value is supplied in LPAR Comment for CPC=
search cancel

SCRT JCL: What value is supplied in LPAR Comment for CPC=

book

Article ID: 266838

calendar_today

Updated On:

Products

COMMON SERVICES FOR Z/OS

Issue/Introduction

Trying to utilize the optional LPAR_Comment to provide commentary in the generate ISV SCRT reports so there is no need to update "(required)" to add justification afterwards.

The CAISCRT sample JCL provided by Common Services in the CAW0JCL library contains the following...  

* OPTIONALLY UNCOMMENT THESE LINES TO PROVIDE AN LPAR COMMENT
* LPAR_Comment CPC= , LPAR= ,
* Comment="................"

1) What is the value that goes in the CPC=?

2) If the LPAR name is just a LPAR grouping, what do I specify in the CPC=?

 

Failure to specify the correct information can result in error message, possibly one of the following:

SCRTTOOL151: ERROR IN PARMS: SYNTAX ERROR IN CPC= KEYWORD

SCRTTOOL155: ERROR IN PARMS: T/S 3907-033ABC LPAR TEST01 NOT FOUND IN DATA

Environment

Release : 15.0

Resolution

Reference the IBM SCRT Usage documentation for help on this topic.

IBM Using the Sub-Capacity Reporting Tool

The following information is documented.

LPAR_Comment
(Required) Identifies the beginning of an LPAR_Comment control statement. The LPAR_Comment
keyword must start in column one. Each LPAR_Comment control statement supports a single
LPAR. Whenever comments are to be provided for multiple LPARs, each LPAR must be specified on
a separate LPAR_Comment control statement.

CPC
(Required) The CPC machine type (tttt) and serial number (sssss) to which this LPAR_Comment
control statement applies, in the format tttt-sssss (for instance, 2094-12345). This
subparameter does not support special values (such as *ALL) nor a list of values. If SCRT does not
find the specified CPC on any of the SMF or SCRT89 records being processed by that execution of
SCRT, it issues an error message and terminates processing with return code 16.

LPAR
(Required) The LPARs to which this LPAR_Comment control statement applies. You can specify the
value in the following ways:

LPAR=nnnnnnnn
A single LPAR name.

LPAR=(nnnnnnnn,nnnnnnnn,...)
A list of LPAR names. Enclose the list in parentheses and separate each name with a comma.

LPAR=*ALL
All LPARs on the specified CPC.

If SCRT does not find the specified LPAR and CPC combination on any of the SMF or SCRT89
records being processed by that execution of SCRT, it issues an error message and terminates
processing with return code 16.

Comment
(Required) The comment text ("ccc…ccc") to display on the sub-capacity report for the specified
LPAR. This must be the last subparameter on the LPAR_Comment control statement, as it is the
only parameter whose value can span multiple lines. The comment text must be enclosed within
double quotation marks and can contain blanks but should not contain commas nor any special
characters that cannot be correctly translated from EBCDIC to ASCII encoding. The comment text
is limited to a maximum of 255 characters and can be continued on multiple lines, as long as each
continuation line is preceded by a line that ends with a comma. The last line of the comment text
should contain no comma.

 

You can use the D M=CPU console command to obtain the LPAR and CPC information as shown below:

D M=CPU
IEE174I 16.59.11 DISPLAY M 670
PROCESSOR STATUS
ID  CPU                  SERIAL
00  +                     013ABC3907
01  +                     013ABC3907
02  +I                    013ABC3907
03  -

CPC ND = 003907.ZR1.IBM.02.000000033ABC
CPC SI = 3907.O06.IBM.02.0000000000033ABC
          Model: ZR1
CPC ID = 00
CPC NAME = MF01
LP NAME = PROD1   LP ID =  1
CSS ID  = 0
MIF ID  = 1

 

Using the above information, a valid LPAR_Comment statement would be defined as follows:

LPAR_Comment CPC=3907-33ABC,LPAR=PROD1,
Comment="Development and Test LPAR"