Example 6: Clearing a lock on a command

In a user syntax file the START-SDF-A command is disabled. This lock is to be cleared.

/set-logon-parameters sdfusr,... ————————  (1)
 .
/show-sdf-options ———————————————————————  (2)
%SYNTAX FILES CURRENTLY ACTIVATED :

%  SYSTEM    : :2OSH:$TSOS.SYSSDF.SDF.045
%              VERSION : SESD04.5A300
%  SUBSYSTEM : :2OSH:$TSOS.SYSSDF.ACO.022
%              VERSION : SESD02.2A00
%  SUBSYSTEM : :2OSH:$TSOS.SYSSDF.ACS.140
%              VERSION : SESD14.0B100
 .
 .
%  SUBSYSTEM : :2OSH:$TSOS.SYSSDF.SDF-A.041
%              VERSION : SESD04.1E10
%  SUBSYSTEM : :2OSH:$TSOS.SYSSDF.TASKDATE.140
%              VERSION : SESD14.0A100
%  GROUP     : 2OSH:$.SYS.SDF.GROUP.SYNTAX.SDFUSR
%              VERSION : UNDEFINED
%  USER      : 2OSH:$SDFUSR.SDF.USER.SYNTAX
%              VERSION : USER001
%CURRENT SDF OPTIONS :

%  GUIDANCE           : *EXPERT
%  LOGGING            : *INPUT-FORM
%  CONTINUATION       : *NEW-MODE
%  UTILITY-INTERFACE  : *NEW-MODE
%  PROCEDURE-DIALOGUE : *NO
%  MENU-LOGGING       : *NO
%  MODE               : *EXECUTION
%     CHECK-PRIVILEGES   : *YES
%  DEFAULT-PROGRAM-NAME : *NONE
%  FUNCTION-KEYS      : *STYLE-GUIDE-MODE
%  INPUT-HISTORY      : *ON
%     NUMBER-OF-INPUTS   : 20
%     PASSWORD-PROTECTION: *YES

1. A task is initiated under the user ID SDFUSR. The user syntax file SDF.USER.SYNTAX cataloged under this user ID is automatically activated when the LOGON command is processed. In this syntax file the START-SDF-A command is disabled.

2. The activated syntax files are listed. The user syntax file SDF.USER. SYNTAX is activated.

   /start-sdf-a ———————————————————————————————————————————  (3)
%  CMD0086 OPERATION NAME 'START-SDF-A' REMOVED BY USER
/mod-sdf-opt synt-file=*rem(*std) ——————————————————————  (4)
/start-sdf-a ———————————————————————————————————————————  (5)
%  BLS0517 MODULE 'SDAMAIN' LOADED
%  SDA0001 'SDF-A' VERSION '04.1E10' STARTED
//open-syntax-file sdf.user.syntax —————————————————————  (6)
//show *com(start-sdf-a) ———————————————————————————————  (7)
%  CMD0051 INVALID OPERAND 'OBJECT=*COM:NAME'
%  SDA0083 NAME 'START-SDF-A' UNKNOWN
%  SDA0407 CORRECTION REJECTED OR NOT POSSIBLE. STATEMENT IGNORED
//restore *com(start-sdf-a) ————————————————————————————  (8)
//end
/mod-sdf-opt synt-file=*add(*std) ——————————————————————  (9)
/start-sdf-a ——————————————————————————————————————————— (10)
%  BLS0517 MODULE 'SDAMAIN' LOADED
%  SDA0001 'SDF-A' VERSION '04.1E10' STARTED
//end
/exit-job
 .
 .

3. SDF does not accept the START-SDF-A command.

4. The user syntax file SDF.USER.SYNTAX is deactivated.

5. SDF accepts the START-SDF-A command, since the user syntax file SDF.USER. SYNTAX is now deactivated. SDF-A is loaded and started.

6. The user syntax file SDF.USER.SYNTAX is opened. By default, the activated system syntax file and the activated group syntax file are assigned as reference files.

7. Since the START-SDF-A command is disabled, SDF-A rejects the attempt to issue it.

8. The lock on the START-SDF-S command is lifted, provided that the assigned reference syntax files contain the definition.

9. The previously edited user syntax file SDF.USER.SYNTAX is activated.

10. The START-SDF-A command is no longer disabled. The lock has been successfully lifted by step 8.