The VERRECOV service recovers a version of a member from the version data set. For retrieval of a member into the hierarchy the information is recovered from the auditing data set defined in the project definition for the group specified to the service. The date and time specified to the service must exactly match the date and time of the audit record with version information to recover. Use the VERINFO service to obtain the dates and times of audit and version information. The VERINFO service sets variable ZSVMBR, which tells the name of the version member. If ZSVMBR is blank after a VERINFO call, then there is an audit record but no version of the member with this date and time. If ZSVMBR is not blank, then there is a version to recover.

The recovery can be done to a data set outside of SCLM control by specifying the to_dataset name parameter. To recover into the SCLM project specify the to_group, to_type and optionally the authcode. When recovering into SCLM, a lock is first done to lock the member at the specified group and type. If the lock fails no recovery will be performed. Either the to_dataset must be specified or the to_group and to_type must be specified to indicate the location of the recovered member.

Command invocation format

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

>--,member--,date--,time--,-+------------+--,-+----------+------>
                            '-to_dataset-'    '-to_group-'   

>--,-+---------+--,-+----------+--,-+---------+----------------->
     '-to_type-'    '-authcode-'    '-dd_msgs-'   

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

Call invocation format

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

>--,member--,date--,time--,to_dataset--,to_group--,to_type------>

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

ISPF interface panel

   Menu  SCLM  Utilities  Help
 ──────────────────────────────────────────────────────────────────────────────
                   SCLM FLMCMD VERRECOV 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)

 Non-SCLM controlled retrieve output data set:
    Sequential Data Set Name . . .                                              

 SCLM controlled retrieve output library:
    Group . . . .         
    Type  . . . .         

 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. 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. 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.

to_dataset

The name of the data set to hold the recovered member. The data set must be a PDS without the member name specified. The data set name must be fully qualified without quotes. If the data set is a PDS the member name will be the name of the member being recovered. If this parameter is specified then the to_group and to_type parameters must not be specified. The maximum parameter length is 44 characters.

to_group

The name of the group to hold the recovered member. The group must be a development group (lowest level of the hierarchy). This parameter requires that the to_type also be specified. If this parameter is specified then the to_dataset must not be specified. The maximum parameter length is 8 characters.

to_type

The name of the type to hold the recovered member. This parameter requires that the to_group also be specified. If this parameter is specified then the to_dataset must not be specified. The maximum parameter length is 8 characters.

authcode

The authorization code to be used for locking the member in the hierarchy. The authorization code must be valid for the group specified in the to_group parameter. If this parameter is not specified and to_group is specified then SCLM will attempt to lock the member with the authorization code that is in the audit record. This parameter requires that the to_group and to_type also be specified. If this parameter is specified then the to_dataset must not be specified. The maximum parameter length is 8 characters.

dd_msgs

The ddname indicating the destination of the messages generated by the VERRECOV service. If you specify a blank ddname, SCLM routes the VERRECOV messages to the default output device, such as your terminal. Otherwise, before you call the VERRECOV 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, with a 4-character year, must be specified in the national language format. 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.