SDF-SIM execution within a procedure or a batch task

Like other utilities, SDF-SIM can also be called in procedures or batch tasks. However, this does not implicitly mean that commands or statements are automatically tested in simulated procedure or batch mode. This is only possible if the DEFINE-ENVIRONMENT statement with the operand PROC-MODE=*YES or TASK-TYPE=*BATCH is entered.

In the case of commands or statements which are tested within a procedure or a batch task in procedure or batch mode, an asterisk (*) must be entered before the slash (/) or double slash (//). If this is not done, the entries will be interpreted as real commands or statements and will actually be processed.

SDF-SIM in a procedure

The following example illustrates the use of SDF-SIM in the procedure SIM.PROC.

Procedure file SIM.PROC

/BEGIN-PROCEDURE LOGGING=A
/ASSIGN-SYSDTA *SYSCMD
/START-SDF-SIM
//DEFINE-TEST-OBJECT *CMD ——————————————————————— (1)
//DEFINE-ENVIRONMENT PAR-FILE=*STD(USER=*NO) ———— (1)
//START-SIMULATION —————————————————————————————— (1)
*CR-FILE AAA,SUPP=LLMLM
*/SH-FI-ATT BBBB
*/*
/ASSIGN-SYSDTA *PRIMARY
/END-PROCEDURE

Tracer listing for the procedure SIM.PROC

(IN)     CALL-PROC SIM.PROC
(IN)     /BEGIN-PROCEDURE LOGGING=A
(IN)     /ASSIGN-SYSDTA *SYSCMD
(IN)     /START-SDF-SIM
(OUT)    %  BLS0523 ELEMENT 'SDF-SIM', VERSION 'V04.5A10' FROM LIBRARY 
(  )      ':2OSH:$TSOS.SYSLNK.SDF-SIM.045' IN PROCESS 
(OUT)    %  BLS0524 LLM 'SDF-SIM', VERSION ' ' OF '2001-04-19 16:11:57' 
(  )      'LOADED
(OUT)    %  BLS0551 COPYRIGHT (C) SIEMENS AG 2001. ALL RIGHTS RESERVED
(OUT)    %  SDS0001 SDF-SIM VERSION 'V04.5A10' STARTED 
(IN)     //DEFINE-TEST-OBJECT *CMD
(IN)     //DEFINE-ENVIRONMENT PAR-FILE=*STD(USER=*NO)
(IN)     //START-SIMULATION
(OUT)    %  SDS0005 ’SYSTEM’ SYNTAX FILE ’$TSOS.SYS.SDF.SYSTEM.SYNTAX’
(   )     ACTIVATED
(IN)     *CR-FILE AAA,SUPP=LLMLM ——————————————————————————————————————  (2) 
(OUT)    (IN)       CR-FILE
(OUT)    %  CMD0051 INVALID OPERAND 'SUPPORT'
(OUT)    %  CMD0081 VALUE 'P' NOT CONTAINED IN KEYWORD LIST OF VALUE RANGE
(  )     '*PUBLIC-DISK() OR *PRIVATE-DISK() OR *TAPE() OR *NONE' 
(IN)     */SH-FI-ATT BBBB —————————————————————————————————————————————  (3) 
(OUT)    (IN)       /SH-FI-ATT BBBB
(OUT)
(OUT)    ENTRY : DCOFSTAT
(OUT)    INTERFACE : ISL
(OUT)    STRING FORM
(OUT)    /FSTATUS BBBB,LIST=(SYSOUT)
(IN)     */*
(OUT)    %  SDS0002 SDF-SIM TERMINATED NORMALLY 
(IN)     /ASSIGN-SYSDTA *PRIMARY
(IN)     /END-PROCEDURE

1. The statements required for simulation preparation are entered and simulation is started.

2. The CREATE-FILE command is simulated. As an invalid value has been specified for the SUPPORT operand, SDF-SIM reports an error.

3. The spin-off mechanism was not triggered, even though there was an input error. As a result, the next command can be simulated immediately. If the command is preceded by a slash (/), there must be an asterisk (*) at the start of the line. Here, however, the slash is not necessary as procedure mode is not being simulated.

SDF-SIM in a batch task

The following example illustrates the simulation of the statements for the test program TESTPRO in a batch task. The prerequisites outlined above for procedures apply here too, so there is no need to reproduce the tracer listing here.

Batch file SIM.ENTER

/LOGON
/START-SDF-SIM
//DEFINE-TEST-OBJECT *STMT(PROG-NAME=TESTPRO)
//DEFINE-ENVIRONMENT PAR-FILE=*STD(USER=TEST.USER),DISPLAY=*SHORT
//START-SIMULATION
*OPEN AAAA,TYPE=*USER, ...   ———————————————————————————————————————————  (1) 
 . 
 . 
*END ——————————————————————————————————————————————————————————————————  (2) 
/LOGOFF 

1. OPEN is a statement defined in the TESTPRO program.

2. If *STMT was specified for DEFINE-TEST-OBJECT, END terminates the SDF-SIM run and issues the message END OF PROGRAM. The END statement is not simulated.