Delete task-specific default values
Component: | SDF |
Functional area: | SDF control |
Domain: | SDF |
Privileges: | STD-PROCESSING |
Function
The RESET-INPUT-DEFAULTS command allows the user to delete task-specific default values. Within the task, default values can be defined for commands and statements. The user can either delete all default values or restrict deletion to default values of commands or of statements. If only defaults of commands/statements are to be deleted, deletion can be restricted to specific commands/statements.
The RESET-INPUT-DEFAULTS command can be applied to a task-specific default value with a particular input serial number. To facilitate this, the output of the SHOW-INPUT-DEFAULTS command can be requested with input serial numbers (operand INPUT-SERIAL-NUMBER=*YES).
In programs with an SDF interface, RESET-INPUT-DEFAULTS is available as a standard statement with the same functionality.
Format
RESET-INPUT-DEFAULTS | Alias: RSID |
Operands
OBJECT = *CMD(...) / *ALL / *STMT(...) / <integer 1..9999>
Specifies the type of input for which the task-specific default values are to be deleted.
OBJECT = *CMD(...)
Only the task-specific default values of commands are deleted. The defaults of all or only of selected commands can be deleted.
CMD = *ALL / <structured-name 1..30 with-wild(50)>
Specifies whether the task-specific default values of all commands or only of selected commands are to be deleted.
CMD = *ALL
All task-specific default values of commands are deleted.
CMD = <structured-name 1..30 with-wild(50)>
Name of the command whose task-specific default values are to be deleted. If wildcards are used, the defaults of all commands which match the search pattern entered will be deleted.
OBJECT = *STMT(...)
Only the task-specific default values of statements are deleted. The defaults of all or only of selected statements of a program can be deleted.
STMT = *ALL / <structured-name 1..30 with-wild(50)>
Specifies whether the task-specific default values of all statements or only of certain statements are to be deleted. In the PROGRAM operand, the user can specify whether the deletion is to apply to defaults of statements of a specific program or of all programs.
STMT= *ALL
All task-specific default values of statements are deleted.
STMT = <structured-name 1..30 with-wild(50)>
Name of the statement whose task-specific default values are to be deleted. If wildcards are used, the defaults of all statements which match the search pattern entered will be deleted.
PROGRAM = *CURRENT / *ALL / <structured-name 1..30>
Specifies the program for whose statements specified in the STMT operand the task-specific default values are to be deleted.
PROGRAM = *CURRENT
Only default values of statements of the program currently defined in the SDF options are deleted. The program name can be set using the MODIFY-SDF-OPTIONS command (DEFAULT-PROGRAM-NAME operand).
PROGRAM = *ALL
The default values of all statements are deleted, regardless of the program name.
PROGRAM = <structured-name 1..30>
Program name, defined in a currently assigned syntax file.
Only default values of statements of the specified program are deleted.
OBJECT = *ALL
All task-specific default values, i.e. from both commands and statements, are deleted.
OBJECT = <integer 1..9999>
Input serial number of the default value to be deleted.
The input serial number of a default value can be taken from the output of the SHOW-INPUT-DEFAULTS command (operand INPUT-SERIAL-NUMBER=*YES).
Return codes
(SC2) | SC1 | Maincode | Meaning/Guaranteed messages |
|---|---|---|---|
0 | CMD0001 | Command executed without errors | |
1 | 0 | CMD0001 | No task-specific default value that matches the specifications exists. |
1 | 32 | CMD0500 | Syntax description in current syntax file invalid. |
1 | 64 | CMD0561 | Command execution not successful |
Example
/!print-doc line-spacing=*by-ebcdic ———————————————————————————————————— (1)
/!cre-file sup=*priv(vol=work01,dev-type=d3435) ———————————————————————— (2)
/!cre-file sup=*public ————————————————————————————————————————————————— (3)
/!cre-file basic-acl=*par(owner=(y,y,y,),group=(y,n,y),others=(y,n,y)) — (4)
/show-input-defaults input-serial-number=*yes —————————————————————————— (5)
/" 1 :" !PRINT-DOC LINE-SPACING=*BY-EBCDIC-CONTROL /" 2 :" !CRE-FILE SUPPORT=*PRIVATE-DISK(VOLUME=WORK01,DEVICE-TYPE=D3435) /" 3 :" !CRE-FILE SUPPORT=*PUBLIC-DISK /" 4 :" !CRE-FILE BASIC-ACL=*PARAMETERS(OWNER=*PARAMETERS(READ=*YES, WRITE=*YES,EXEC=*YES),GROUP=*PARAMETERS(READ=*YES,WRITE=*NO,EXEC=*YES), OTHERS=*PARAMETERS(READ=*YES,WRITE=*NO,EXEC=*YES))
/cre-file test.x.1,sup=*priv —————————————————————————————————————————— (6)
/cre-file test.x.2
/show-file-attr test.x.,alloc=*yes
%00000003*:2OSG:$USERXY01.TEST.X.1 % ------------------------------- ALLOCATION ------------------------------- % SUPPORT = PVT S-ALLOC = 9 HIGH-US-PA = 0 % EXTENTS VOLUME DEVICE-TYPE EXTENTS VOLUME DEVICE-TYPE % 1 WORK01 D3435 % NUM-OF-EXT = 1 %00000009 :2OSG:$USERXY01.TEST.X.2 % ------------------------------- ALLOCATION ------------------------------- % SUPPORT = PUB S-ALLOC = 9 HIGH-US-PA = 0 % EXTENTS VOLUME DEVICE-TYPE EXTENTS VOLUME DEVICE-TYPE % 1 2OSG.1 D3435 % NUM-OF-EXT = 1 %:2OSG: PUBLIC: 1 FILE RES= 9 FREE= 9 REL= 9 PAGES %:2OSG: PRDISC: 1 FILE RES= 3 FREE= 3 REL= 0 PAGES
/reset-input-defaults 2 ——————————————————————————————————————————————— (7)
/reset-input-defaults *cmd(cmd=create-file) ——————————————————————————— (8)
/show-input-defaults —————————————————————————————————————————————————— (9)
/!PRINT-DOC LINE-SPACING=*BY-EBCDIC-CONTROL
(1) | Evaluation of EBCDIC print control characters is set as the default value for the PRINT-DOCUMENT command. The LINE-SPACING operand is specified without a structure-initiator because in the syntax file *TEXT-FORMAT the default value of the operand is DOCUMENT-FORMAT. |
(2) | The private disk WORK01 of device type D3435 is set as the default value for the CREATE-FILE command. In this case, the structure-initiator must be specified, because the VSN and the device type refer to a private disk. To create a file on a public disk, SUPPORT=*PUBLIC must now be specified (see item 6). |
(3) | Public disks are again set as the default for the CREATE-FILE command; but to create a file on the private disk WORK01, it is sufficient to specify SUPPORT=*PRIVAT. |
(4) | For the CREATE-FILE command, the value set by default is a BASIC-ACL, which grants all access rights only to the owner, but allows the other users to read and execute the file. The protection attribute is set accordingly if the higher-ranking structure is activated with PROTECTION=*PARAMETERS. |
(5) | All task-specific default values are output with their input serial numbers. |
(6) | The file TEST.X.1 that was created with CREATE-FILE and SUPPORT=*PRIVATE-DISK on the private disk WORK01, the file TEST.X.2 was created without SUPPORT on a public disk. |
(7) | The definition with the input serial number 2 is deleted. In this case this is the definition with CREATE-FILE for the private disk. |
(8) | All definitions for the CREATE-FILE command are deleted. |
(9) | The output of the task-specific default values now shows only the definition for the PRINT-DOCUMENT command. |