The VERINFO service retrieves the information about a versioned or audited member into ISPF variables and tables. The service can search a group for the next or previous matching audit record, or retrieve a specific audit record. See ISPF variables for a list of the variables updated by this service.

Command invocation format

>>-FLMCMD--VERINFO,project--,-+---------+--,group--,type-------->
                              '-prj_def-'                  

>--,member--,-+------+--,-+------+--,-+-----------------+------->
              '-date-'    '-time-'    '-user_info_table-'   

>--,-+---------------+--,-+-------------------+----------------->
     '-include_table-'    '-change_code_table-'   

                         .-FORWARD--.                  
>--,-+--------------+--,-+-BACKWARD-+--,-+---------+------------>
     '-ada_cu_table-'    '-MATCH----'    '-dd_msgs-'   

>--,-+----------+----------------------------------------------><
     '-longdate-'   

Call invocation format

>>-lastrc--:=--FLMLNK('VERINFO--',sclm_id,--,group--,type------->

>--,member--,date--,time--,user_info_table--,include_table------>

                                        .-FORWARD--.   
>--,change_code_table--,ada_cu_table--,-+-BACKWARD-+------------>
                                        '-MATCH----'   

>--,$msg_array--+-----------+--);------------------------------><
                '-,longdate-'       

ISPF interface panel

   Menu  SCLM  Utilities  Help
 ──────────────────────────────────────────────────────────────────────────────
                   SCLM FLMCMD VERINFO Service - Entry Panel
                                                                    More:     +
 SCLM Library:
    Project . . . SCLMTEST
    Alternate . .         
    Group . . . . DEV1    
    Type  . . . . SOURCE  
    Member  . . .         

 Date of audit or version  . . . . .             (In ZDATEF format)
 Time of audit or version  . . . . .              (In HH:MM:SS.hh format)
 Search type . .    1. Search
                    2. Forward
                    3. Match


 Names of open tables for service output:
    User Info . . . . . . .         
    Includes  . . . . . . .         
 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. This parameter is used for FLMCMD only.

sclm_id

An SCLM ID associated with a given project and project definition. The INIT service generates the SCLM ID. The maximum parameter length is 8 characters. This parameter is used for FLMLNK only.

group

The group associated with the version or audit record. The maximum parameter length is 8 characters.

type

The type associated with the version or audit record. The maximum parameter length is 8 characters.

member

The member that has the version or audit record. The maximum parameter length is 8 characters.

date

The date of the version or audit record. If omitted or specified as blanks the longdate is used. If both the date and longdate are omitted or specified as blanks, the date will default to 00/00/00. The date must be specified in the format given in the ZDATEF ISPF variable. The length of this parameter is 8 characters.

time

The time of the version or audit record. If omitted or specified as blanks the time will default to 00:00:00.00. The format for the time is HH:MM:SS.hh or HH:MM:SS,hh where HH is the hour from a 24 hour clock, MM is the minute, SS is the seconds and hh is the hundredths of seconds. The length of this parameter is 11 characters.

user_info_table

The name of the ISPF table to contain the user entries from the audit record. The table must be open before calling the VERINFO service. A TBADD will be performed for each user entry in the audit record. The maximum parameter length is 8 characters. The following ISPF variables must be used in the table definition in order to have their value stored in the table:

• ZSUNUM - the user entry number
• ZSUENTRY - the user entry data

include_table

The name of the ISPF table to contain the includes from the audit record. The table must be open before calling the VERINFO service. A TBADD will be performed for each include in the audit record. The maximum parameter length is 8 characters. The following ISPF variables must be used in the table definition in order to have their value stored in the table:

• ZSIMBR - the include member name
• ZSIISET - the include set name

change_code_table

The name of the ISPF table to contain the change codes from the audit record. The table must be open before calling the VERINFO service. A TBADD will be performed for each change code in the audit record. The maximum parameter length is 8 characters. The following ISPF variables must be used in the table definition in order to have their value stored in the table:

• ZSCCODE - the change code
• ZSCDATE - the change code date in 2-character date format
• ZSCDAT4 - the change code date in 4-character date format
• ZSCTIME - the change code time

ada_cu_table

The name of the ISPF table to contain the ADA compilation units from the audit record. The table must be open before calling the VERINFO service. A TBADD will be performed for each ADA compilation unit in the audit record. The maximum parameter length is 8 characters. The following ISPF variables must be used in the table definition in order to have their value stored in the table:

• ZSDNAME- the ADA compilation unit name
• ZSDTYPE - the ADA compilation unit type

FORWARD|BACKWARD|MATCH

FORWARD indicates that if the type name, member name, date, or time do not exactly match an audit record, the information from the next audit record for the group is to be returned. This is the default.

BACKWARD indicates that if the type name, member name, date, or time do not exactly match an audit record, the information from the previous audit record for the group is to be returned.

MATCH indicates that the type name, member name, date, and time must exactly match the type name, member name, date, and time in an audit record.

To retrieve all of the audit records within a group use FORWARD and start with the type name and member name set to blanks and the date and time set to all zeros. If an audit record is found increment the last digit of the time by one before calling the VERINFO service again. Repeat this process until the service indicates that no record was found.

The maximum parameter length is 8 characters.

dd_msgs

The ddname indicating the destination of the messages generated by the VERINFO service. If you specify a blank ddname, SCLM routes the VERINFO messages to the default output device, such as your terminal. Otherwise, before you call the VERINFO service, you must allocate the ddname. The following attributes should be used: RECFM=F, LRECL=80, BLKSIZE=80. The maximum parameter length is 8 characters. This parameter is used for FLMCMD only.

$msg_array

An output parameter pointing to the message array. See Pointer parameter descriptions for more information about $msg_array. This parameter is used for FLMLNK only.

longdate

The date of the version or audit record. If omitted or specified as blanks the date parameter is used. If both the date and longdate are omitted or specified as blanks, the date will default to 00/00/00. The longdate must be specified in the national language format with a 4-character year. The length of this parameter is 10 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 or the FLMLNK processor. See SCLM service return codes for more information.