F u n c t i o n The LOAD statement identifies the program to be executed and indicates whether the program will be loaded from the system input device for the partition, from an 6bject l i b r a r y , o r f r o m a f i l e o n a m a i n d a t a a r e a .
One LOAD statement is required for each program executed. On systems being run in step mode, the only requirement is that the LOAD statement precede the RUN state' ment. The LOAD statement mustfollow the JOB statement, and precede the RUN statement when operating in job mode. Any number of job steps (LOAD/RUN com-binations) may follow a JOB statement. For a complete description of job mode and step mode see Part 2 of this manual.
The LOAD statement has the following formats:
Placement
/ / [ s t e p n a m e ] L O A D *
[ , p r o g r a m - n a m e 1 , u n i t 1 ]
[,switch characters] (a blank is mandatory between LOAD and *.]
Contents
/ / [ s t e p n a m e ] L O A D p r o g r a m - n a m e 2 , u n i t 2 [,switch characters]
The first format is used to load object programs from the system input device or from a file on a main data area. The second format is used to load object programs from an o b j e c t l i b r a r y .
stepname: This optional entry is used to uniquely identify a job step. lf specified, the stepname must begin in position 3 of the statement. must not exceed 8 characters in l e n g t h . a n d m u s t n o t c o n t a i n a c o m m a . S t e p n a m e s ( a n d j o b n a m e s ) s h o u l d c o n t a i n o n l y characters that are on the 3277 Display Station keyboard. lf the stepname contains characters not on the 3277 keyboard, that step cannot be referenced by its stepname by using commands. These nondisplayable characters may also cause display problems when written to the 3277 display. The stepname is displayed on the display screen with system messages associated with the job step. lf a stepname is not specified, the system assigns a stepname to each step. The stepname assigned by the system is made up of the program name from the LOAD statement and a 2-digit number assigned by the system. Stepnames assigned by the system are incremented by one at end of job step in which a stepname is
assigned. lf a LOAD *
statement without a stepname is encountered. the system assigns a stepname of ASTRSKnn. The number portion of the stepname is reset to 1 at end of job. After 99 stepnames have been assigned within one job. the number is reset to 1.
When the print and punch queues are displayed, the stepname identifies job steps on the q u e u e s .
Asterisk: An asterisk is specified when the user wants the obiect program loaded from the partition's system input device or from a file on a main data area. The obiect pro-gram must follow the RUN statement if the program is loaded from the partition's system input device, and a /* statement must follow the object program to indicate the end of the object program input. The object program is temporarily copied into the object library on the system pack and then loaded into main storage for execution. LOAD "
programs are accepted in any partition; however, while a LOAD * program with overlays is running. no other LOAD * programs can be loaded. When a subsequent LOAD 'pro-gram is received, the system issues a diagnostic, which allows the user either to wait for completion of the LOAD * program or to cancel the subsequent LOAD * program.
L O A D a n d L O A D ' S t a t e m e n t 1 - 7 5
Program-namel.' This entry identifies the file that contains the oblect program to be loaded. The program-namel can be any combination of characters except commas, apostrophes, or embedded blanks. The first character must be alphabetic. The length must not exceed 6 characters.
unitl: This entry specifies the main data area that contains the file from which the object program is to be loaded. Possible codes are those for the main data areas.
y'y'ote.' Although the user does not specify an ocl FILE statement,the LOAD * from f i l e fu n c t i o n r e q u i r e s a n F 1 e n t r y in t h e S W A . T h e s y s t e m p r o d u c e s a s i m u l a t e d F I L E statement to protect the file from which the program is being loaded. Therefore, the number of available file statements that can be used when a program is loaded from a file i s r e d u c e d b y 1 . T h e p r o g r a m - n a m e l p a r a m e t e r m u s t id e n t i f y t h e f i l e w h i c h c o n t a i n s t h e program being loaded.
Switch characters: The switch characters (0, 1, and X) are optional. When you include them, you must supply 8 characters because they are compared with the eight external indicators. The system compares each position if the switch character is a 0 or l. An X cancels the compare operation for that position only. The first (leftmost) switch character is compared with external indicator 1; then the second switch character is compared with external indicator 2. This process continues until the 8 switch characters and the eight external indicator positions are either compared or bypassed. lf an equal condition exists, the program is loaded. otherwise, an informational message is displayed and the job stream is flushed to the next step.
The program-namel and the unitl parameters are positional parameters. Therefore, if you include the switch characters without these parameters, you must separate the *
and the switch characters with either 1 or 3 commas. For example:
/ / L O A D * , x x x x x x x x o r
ll LOAD *,.,xxxxxxxx
program-name2: The program-name2 is the name used to identify the program in the object library. Program-name2 may be up to 6 characters in length. The name must begin with one of the 29 alphabetic characters (A-2, @, #, or $) and may be followed by up to 5characters. commas, apostrophes, periods, and blanks may not be used in the name.
The system service programs and program products are identified by the following names:
Program Name
Restart $$RSTR
Alternate Track Assignment $ALT
Basic Assembler $ASSEM
R P G ll A u t o - R e p o r t $ A U T O A l t e r n a t e T r a c k R e b u i l d S B U I L D C O B O L C o m p i l e r $ C B L 0 O Communication Control Program $CCP
Card List $CL|ST
Configuration Record $CNFIG
Copy/Dump $COPY
Card Sort/Collate $CSORT
Dump/Restore SDCOPY
F i l e D e l e t e $ D E L E T
C C P / D i s k S o r t $ D G S R T 1-76
Program D i s k S o r t F i l e C o m p r e s s F O R T R A N G a n g p u n c h
System l{istory Area Display D i s k In i t i a l i z a t i o n
C h a i n C l e a n i n g
F i l e a n d V o l u m e L a b e l D i s p l a y Library Maintenance
Macro Processor O v e r l a y L i n k a g e E d i t o r S p o o l F i l e C o p y
C a r d R e p r o d u c e a n d I n t e r p r e t R e c o v e r I n d e x
R P G l l C o m p i l e r Reassign Alternate Track S i m u l a t i o n A r e a
T a p e In i t i a l i z a t i o n Tape Sort
Tape Error Summary Program VTOC Service
Name
$ D S O R T
$ F C O M P
$ F O R T
$ G A N G P
$ H I S T
$ I N I T
$ K L E A N
$ L A B E L
$ M A I N T
$ M P X D V
$ O L I N K
$ocoPY
$ R E P R O
$ R I N D X
$ R P G
$ R S A L T
$SCOPY
$ T I N I T
$TSORT
$ T V E S
$WVTOC
E x a m p l e
Unit2: fhe unit2 parameter is a required code. lt indicates the simulation area that c o n t a i n s t h e p r o g r a m . P o s s i b l e c o d e s a r e R 1 , F 1 , R 2 , F 2 .
The disk area containing your object program is called an object library. You can create an object library on any of the simulation areas by using the library mainrenance program.
(See Library Maintenance Program in Part 4 of this manual.)
I n t h e f o l l o w i n g s a m p l e L O A D s t a t e m e n t , $ R P G is th e n a m e t h a t i d e n t i f i e s t h e R P G ll c o m p i l e r .
F 1 i s t h e c o d e in d i c a t i n g t h e s i m u l a t i o n a r e a w h e r e t h e c o m p i l e r i s lo c a t e d .
The system would assign a stepname of $RPG01, because a stepname is not specified on the LOAD statement.
The following example shows a stepname assigned by the user:
T h e s y s t e m w o u l d u s e t h e s t e p n a m e R P G F l .
L O A D a n d L O A D * S t a t e m e n t 1 - 7 7
Il
z
E I|
a
g
The following example shows how the switch characters can be used to determine whether or not a job step will be executed. Assume that a program has just completed executing s u c c e s s f u l l y a n d h a s s e t th e e x t e r n a l i n d i c a t o r s t o 1 0 1 0 1 0 1 0 . T h e o C L s t a t e m e n t s f o l l o w i n g t h e c o m p l e t e d p r o g r a m a r e :
Step 1 is not executed because the external indicators do not agree with the switch characters. An informational message with the value of the external indicators is issued. The system then flushes to the next step (step 2).
Step 2 is executed because the external indicators agree with the switch characters.
(The switch character X tells the system to cancel the compare operation with the relative external ind icator. )
Step 3 is executed after step 2 is completed.
The following example shows the ocL statements and parameters needed to load a p r o g r a m f r o m a f i l e :
The LoAD * identifies the requested function. The program is processed as a LoAD * type program. The same rules and restrictions that apply to a program loaded from the s y s t e m i n p u t d e v i c e a l s o a p p l y to a p r o g r a m t h a t i s lo a d e d f r o m a f i l e .
The program-name (MNO) must be the name of the file that contains the program.
The program is contained in a file that is located on a main data area (D42). The program is copied to the object library on the system pack before being loaded into main storage for execution. The system pack becomes the program pack for all LOAD * programs regardless of whether they are loaded from disk or from the system input device.
N o n e S p o o l i n g C o n s i d e r a t i o n s
1-78