SCLMINFO—Return Project Information

The SCLMINFO service returns information about an SCLM project. This information is retrieved by reading the SCLM project definition load library.

The project information is returned in the following ISPF variables:

ZSCIPROJ: Project specified by the user
ZSCIPDEF: Alternate specified by the user
ZSCIGRP: Group information for the project
ZSCITYPE: Type information for the project
ZSCILANG: Language information for the project
ZSCISVER: SCLM version ID for the project
ZSCITMST: Timestamp (date and time when the project was generated)
ZSCIACTF: Accounting file names for the project
ZSCIAUT: Authorization code information for the project
ZSCINPAT: Data set name patterns information for the project

ZSCIGRP contains a list of all the groups specified for this project. The following information is returned for each group:

LV=001 GR=RELEASE

You must parse the variable to retrieve the information for each group.

ZSCITYP contains a list of all the types specified for this project. The following information is returned for each type:

TY=ARCHDEF XT=nnnnnn

You must parse the variable to retrieve the information for each type. The XT= information will only be displayed if you have specified the "EXTEND=" on the FLMTYPE macro when defining the project.

ZSCILANG contains a list of all the languages specified for this project. Here is an example of the information that is returned for each language:

LA=HLAS     LD=HLASM TRANSLATOR

You must parse the variable to retrieve the name and description of each language.

ZSCIACTF contains the concatenation of the names of all accounting files specified for this project. Each name is padded to 44 bytes.

ZSCIAUT contains a list of all the authorization codes specified at each group for this project. Here is an example of the information that is returned for each group:

GR=TEST     AC=P        D

You must parse the variable to retrieve the authorization codes for each group.

With the PTFs for APAR OA21104 applied, ZSCINPAT contains a list of all the data set patterns used for each group for this project. Even if flexible data set naming has not been used on the FLMCNTRL, or FLMALTC macros, this variable will be returned with the default pattern of @@FLMPRJ.@@FLMGRP.@@FLMTYP specified for each group. Here is an example of the information that is returned for each group:

GR=PROD     NP=@@FLMPRJ.V2.@@FLMGRP.@@FLMTYP

You must parse the variable to retrieve the data set pattern for each group.

Command invocation format


>>-FLMCMD--SCLMINFO,project--,-+---------+---------------------><
                               '-prj_def-'

Call invocation format


>>-lastrc--:=--FLMLNK('SCLMINFO',project,prj_def);-------------><

ISPF interface panel

Figure 1. SCLMINFO Service panel

   Menu  SCLM  Utilities  Help
 ──────────────────────────────────────────────────────────────────────────────
                   SCLM FLMCMD SCLMINFO Service - Entry Panel

 SCLM Hierarchy:
    Project . . . SCLMTEST
    Alternate . .         

 DD Name for output data set:
    Error message data set           (Blank to write messages to the terminal)











 Command ===>                                                                  
  F1=HELP      F2=          F3=END       F4=DATASETS  F5=FIND      F6=CHANGE
  F9=SWAP     F10=LEFT     F11=RIGHT    F12=SUBMIT

Parameters

project: The project name. The maximum parameter length is 8 characters. This parameter is used for FLMCMD only.
prj_def: The project definition name. It defaults to the project name. The maximum parameter length is 8 characters.

Return codes

Additional special services messages are written to the FLMMSGS ddname. See SCLM service messages for more information.

Other return codes might be produced by the FLMCMD processor. See SCLM service return codes for more information.

Possible return codes are:

0: Normal completion. The information was retrieved successfully.
12: Error completion. Refer to the messages for more information.