Chapter 5. Sign-On, Recovery, and End of Job
11 MEMBER PROGRAM2-#SE#M2
I I
LOAD #SEUI I
WORKSTN RESTORE-YES,UNIT-display station IDI I
RUN11
SEU NAME-member name,TYPE-member type,I I
ENDFORMAT-format member name,LENGTH-statement length, LIBRARY-library name
Note: If your system has ideographic support, you can specify that the extended character file not be used. To do so, add the parameter EXTN-OFF to the work station OCL statement in the SEU procedure. The statement would be:
11
WORKSTN RESTORE-YES,UNIT-?WS?,EXTN-OFFFor more information, see Work Station Statement in Chapter 2 of the System Support Reference Manual.
Sample SEU Commands
Assume that (1) an SEU job is to create a source member named RPG RUN, (2) the member will contain RPG II specifications, (3) the job will use the display screen formats in the format load member #SE@FORM and #SE@XTRA, (4) the statement length for the member is 96, the default length, and (5) the member will reside in #LIBRARY, the default library name. The sign-on command for the job is:
Assume that (1) an SEU job is to change the source member named SORTA, (2) the member contains sort sequence specifications, (3) the sort formats are in the format load member #SE@XTRA, (4) the statement length for the member is 96, the default length, and (5) the member resides in the library named USERLIB1. The sign-on command for the job is:
fSIElUf lslolRlr!AI .,Isl, I ,I, lulslEIRILlrlij1!
Assume that (1) an SEU job is to create a procedure member named PROCM, (2) the display screen formats created especially for this kind of job reside in the format load member named MRTFORM, (3) the statement length for the procedure member is 96, and (4) the new procedure member will reside in the library named USERLIB2. The sign-on command for the job is:
The SEU command you would enter to sign on SEU for the sample job described .in Chapter 2 under An Example of How to Change a Display Screen Format is:
ISIE!ul lilslE~l~lo!R\M\., [5TJJ8~
• The member being changed is the source member #SE@FORM, which contains the display screen format specifications that define the RPG II and auto report control specification display screen format (H).
• Format member name is not required because the display screen format SFGR-D, which you would use to enter changes for #SE@FORM, is in the format load member #SE@FORM.
• The length of the statements in the source member #SE@FORM is 80.
Sample Sign-On Displays
Displays During Sign-On
Figure 5-1 shows the kind of display that appears after the operator enters the SEU command if member name or member type (parameters l and 2) is not entered. Any parameters that are entered on the initial command appear to the right of the corresponding prompts on this screen. The default value of
#LIBRARY appears if nothing is entered for the library parameter.
The operator should key parameters that should be added, key over any displayed parameters that should be changed, and then press the Enter/Rec Adv key to enter these parameters. If the member name or member type still are not entered, the system will prompt for them again.
r
xxxxxxxx
SEU PROCEDURE OPTIONAL-IOl
AN INTERACTIVE UTILITY PROGRAM THAT HELPS THE USER CREATE, CHANGE, DELETE AND LOCATE STATEMENTS IN SOURCE AND PROCEDURE MEMBERS. . MEMBER NAME .•.••.•...••••...••...•..•.••••••.•..••.•••.
MEMBER TYPE I A/R/S/F /W/P/Tl ...••..••.••.••••••••.•..•••••.•
FCR!1AT MEMBER NAME. . • • • . • . • . . • . . . • • • • • • • • • • . • • . • . . • • • • • • . • • #SEO)XTRA ( 0 l STATEMENT LENGTH... ( 0) NAME OF LIBRARY CONTAINING THE MEMBER •••.••.••.•..••.•••••• #LIBRARY
This display appears if the operator enterd the SEU command but did not enter both member name and member type.
Figure 5-1. Sample Sign-On Prompt Display
Displays After Sign-On Is Complete
Figure 5-2 shows the kind of display that appears after the operator signs on SEU to create a member. Figure 5-3 shows the kind of display that appears after the operator signs on SEU to change an existing member. Note that in both figures the free-form format Z is shown. Z is always the first display screen format shown after SEU sign-on.
r
16 120
z
096 s ENTERxxxxxxxx
l 2 3 4 5 6 7
1234567890123456789012345678901234567890123456789012345678901234567890123456789
8 9 0 l 2
01234567890123456789012345678901234567890
0001.00 -ENTER/UPDATE STATEMENT NUMBER
The operator signed on to create a source member containing RPG II specifications.
Figure 5-2. Semple Sign-On Display: Create
16 120 z 096 s
0001. 00 0001 FINPUT UC F 256 64R 8AI DISK U8 DEFINE INPUT FILE
xxxxxxxx
0002.00 0002 FMASTER IS 257 257 3 SPECIAL SUB RAC DEFINE MASTER FILE
0003.00 0003 FBACKUP IP AF 200 200 29Al 72 DISK 0004.00 0004 FD I SKIN IR F 96 96 30IT EDI SK 0005.00 0005 FKEYIN IP F 128 128 KEYBORD 0006.00 0006 FFILENAMEIP F 80 80 KEYBORD
A 01
RECOVERY
SEU provides a way to recover from error conditions and system failures. If an error conditions exists, such as the required disk space for the work file is not available, or if a system failure such as power failure occurs, the operator can later recover data from the SEU work file by:
• Signing on at the display station being used at the time the error condition or failure occurred
• Entering the same SEU command that was entered for the original job After the SEU command is entered, SEU determines whether or not data can be recovered from the work file and displays the appropriate messages. The operator can continue the job if recovery is possible, although some of the entries made just prior to the failure may have to be repeated.
If the SEU command entered for recovery is not the same as the command that was entered for the original job, SEU displays an error message. One of the options available as a response to the message causes SEU to display the parameters in the original SEU command.
A second command display station can request an SEU work file at the time a display station is running SEU. Each display station running SEU has a work file assigned to it. Although no job other than the SEU job using the work file should refer to the work file, some system utility programs are able to refer to SEU work files. If a different program is using the SEU work file at the time SEU goes to end of job, SEU does not delete the work file at SEU end of job.
Consequently, when SEU is signed on again at the display station, the prompts and displays that appear are the same as those displayed during SEU recovery.
Note: SEU cannot recover from permanent disk errors.