The VERDEL service deletes the
information about a versioned or audited member from SCLM. The information
is deleted from the auditing data set defined in the project definition
and from the versioning PDS associated with the audit record, if it
exists. The partitioned data set used for storing the versions is
also updated for deletion of the version. The date and time specified
to the service must exactly match the date and time of the audit and
version information to delete. Use the VERINFO service to obtain the
dates and times of audit and version information.
Command invocation format
>>-FLMCMD--VERDEL,project--,-+---------+--,group--,type--------->
'-prj_def-'
>--,member--,date--,time--,-+---------+--,-+----------+--------><
'-dd_msgs-' '-longdate-'
Call invocation format
>>-lastrc--:=--FLMLNK('VERDEL--',sclm_id,--,group--,type-------->
>--,member--,date--,time--,$msg_array--+-----------+--);-------><
'-,longdate-'
ISPF interface panel
Figure 1. VERDEL Service panel Menu SCLM Utilities Help
──────────────────────────────────────────────────────────────────────────────
SCLM FLMCMD VERDEL Service - Entry Panel
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)
DD Names for output data sets:
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. 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. Either the date or
the longdate parameter is required. If both are given, the date parameter
is used. 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.
- dd_msgs
- The ddname indicating the destination of the messages generated
by the VERDEL service. If you specify a blank ddname, SCLM routes
the VERDEL messages to the default output device, such as your terminal.
Otherwise, before you call the VERDEL 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. The longdate, with a
4-character year, must be specified in the national language format.
Either the date or the longdate parameter is required. If both are
given, the date parameter is used. 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.
Possible
return codes are:
- 0
- Normal completion. The audit and version information were deleted.
- 8
- Error completion. No audit and version information was deleted.
No audit record was found that matches the specified criteria.
- 12
- Error completion. Refer to the messages for more information.