F u n c t i o n T h e I N C L U D E s t a t e m e n t i d e n t i f i e s t h e e n t r y ( p r o c e d u r e ) i n t h e s o u r c e l i b r a r y t h a t c o n -tains the OCL statements to be merged into the job stream. When printed. the merged OCL statements are identified by an X/ preceding the statement identifier. The source member to be included into the job stream cannot contain a CALL statement.
The INCLUDE statement can appear anywhere among the OCL statements. lt must p r e c e d e t h e R U N s t a t e m e n t ( i f R U N is used) i n a p r o c e d u r e . N e s t e d I N C L U D E s t a t e -ments are not allowed.
/ / I N C L U D E p r o c e d u r e - n a m e , u n i t [ , s w i t c h c h a r a c t e r s ]
Procedure-name.' This name identifies the procedure in the source library. lt must be the same name that was supplied in the library maintenance control statement when the procedure was entered in the source library.
U n i t : T h e u n i t p a r a m e t e r i s a r e q u i r e d c o d e . T h e c o d e i d e n t i f i e s t h e s i m u l a t i o n a r e a t h a t contains the procedure. Possible codes are R 1, F 1 , R2, F2.
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 does a comparison for each position if the switch character is a 0 or 1. An X cancelsthe 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 INCLUDE statement is accepted. Otherwise, an informational
message is displayed and the INCLUDE statement is not accepted.
Placement
I N C L U D E S t a t e m e n t 1 - 6 9
Example / / s w r T C H 1 0 1 0 1 0 1 0 / / L O A D A B C . F l
/ / I N C L U D E X , R 1 , 1 O 1 O 1 O 1 O / i T N c L U D E Y . R 1 , 0 1 0 1 0 0 1 1 / / I N C L U D E Z , R l , X O X O X O 1 O / / R U N
|| This INCLUDE statement is accepted, and the OCL statements in procedure X are merged into the job stream.
Z This INCLUDE statement is not accepted, and an informational message is d i s p l a y e d .
E This INCLUDE statement is accepted, and the OCL statements in proced ure Z are merged between procedure X OCL statements and the RUN statement. The job stream is changed as follows:
l l s w t T c H 1 0 1 0 1 0 1 0 / / L O A D A B C , F l
l l t N C L U D E X . F t , 1 0 1 0 1 0 1 0
x/ DATE O51O77 )
X I F I L E N A M E . A , U N I T - D 1 , P A C K - D I D 1 D 1 ) P r o c e d u r e X X I F I L E N A M E . B , U N I T . D I , P A C K - D 1 D I D l )
/ / t N c L U D E Y . F 1 . 0 1 0 1 0 0 1 1
C R F L S H I A B C O 1
i *
T H I S I N c L U D E B Y P A S S E D * *
I N D I c A T o R S - 1 0 1 0 1 0 1 o * * / / I N C L U D E Z , F I , X O X O X O I O
X l F I L E N A M E . D . U N I T . D 2 , P A C K - D 2 D 2 D 2
X l F I L E N A M E - E , U N t T - D 2 , P A C K - D 2 D 2 D 2 )| p r o c e d u r e Z X I F I L E N A M E - F , U N I T - D 2 . P A C K - D 1 D a D 2 )
/ / R U N Spooling Considerations None
Il a
E
P a s e o f G C 2 1 - 5 1 6 2 - 1 l s s u e d 2 8 S e p t e m b e r 1 9 7 9 B v T N L : G N 2 1 - 5 6 7 4
JOB Statement Function
Placement
Format
Content
The JOB statement allows you to group related job steps together to ensure that they are r u n s e q u e n t i a l l y . T h e s y s t e m d o e s n o t i n i t i a t e t h e n e x t s t e p o f a j o b u n t i l t h e p r e v i o u s l o b s t e p h a s b e e n c o m p l e t e d s u c c e s s f u l l y . l t i s r e q u i r e d o n s y s t e m s t h a t h a v e a c t i v e s p o o l i n g o r o n n o n s p o o l i n g s y s t e m s r u n n i n g i n j o b m o d e .
T h e J O B s t a t e m e n t m u s t p r e c e d e t h e f i r s t L O A D o r C A L L s t a t e m e n t . l t c a n n o t b e used in a orocedure.
//jobname JOB parameters
J o b n a m e : T h i s i s a r e q u i r e d e n t r y u s e d to u n i q u e l y i d e n t i f y a j o b . l t m u s t b e g i n in position 3, may not exceed 8 characters in length, and may not contain a comma. When the last two characters of a jobname are asterisks (**), the system replaces them with a s e q u e n c e n u m b e r . T h e a s s i g n e d n u m b e r ( f r o m 0 1 t h r o u g h 9 9 ) i s i n c l u d e d in a n i n f o r m a -tional message.
J o b ( a n d s t e p ) n a m e s s h o u l d c o n t a i n o n l y c h a r a c t e r s t h a t a r e o n t h e 3 2 7 7 D i s p l a y S t a t i o n keyboard. ff the jobname contains characters that are not on the 3277 keyboard, that j o b c a n n o t b e r e f e r e n c e d b y i t s j o b n a m e b y u s i n g c o m m a n d s . T h e s e n o n d i s p l a y a b l e characters may also cause display problems when written lo the 3277 display. The iob-name is displayed on the display screen with system messages and halts associated with t h e j o b . l t i s a l s o th e n a m e b y w h i c h j o b s a r e i d e n t i f i e d o n t h e s p o o l i n g q u e u e s . A l l p a r a m e t e r s a r e o p t i o n a l . T h e y a r e a s fo l l o w s ( d e f a u l t s a r e u n d e r l i n e d ) :
C O R E - n n n ( c a n b e 1 , 2 , o r 3 d i g i t s ) S P O O L
-P A R T I T I O N .
,-,", ," Ill
t i t
J I
1 2 3 A B
c
D f Y E S
l r u o
ocoPY-I Y E S I t N o )
J O B S t a t e m e n t 1 - 7 1
PRIoRITY: A priority may be assigned to a job to indicate its level of importance on the reader or output queues. The priority of the job steps for a job on the output queues is t h e p r i o r i t y a s s i g n e d t o t h a t jo b o n t h e r e a d e r q u e u e u n l e s s o v e r r i d d e n b y a p R l O R l T y p a r a m e t e r o n a P R I N T E R o r P U N C H s t a t e m e n t . p r i o r i t y 0 indicates a p r i o r i t y I j o b . which is to be held on the reader queue until released via an operator control command.
(See Appendix C for a summary of operator control commands.) Priority 5 is the highest priority that may be assigned. within a given priority, jobs are scheduled on a first-in, first-out basis. lf this parameter is not specif ied, priority r is assumed.
CORE: This parameter specifies the amount of main storage required to execute the l a r g e s t s t e p in a j o b a n d e s t a b l i s h e s a m i n i m u m p a r t i t i o n s i z e f o r t h e d u r a t i o n o f t h a t jo b . {lt does not assign main storage to the partition; a SET command must be used for this purpose.) when this parameter is not specified, the system assumes that the job is scheduled in a partition with adequate main storage and uses the present partition size as t h e m i n i m u m f o r t h e jo b . E i g h t is th e m i n i m u m value t h a t m a y b e s p e c i f i e d ; 2 3 g is t h e maximum value that may be specif ied. Anything less than 8K is treated as 8K. This can b e in c r e a s e d i n 2 K i n c r e m e n t s u p t o a m a x i m u m o f 2 3 g K . l f t h e p a r a m e t e r i s n o t a 2 K increment, it is rounded up to the next 2K increment. when the coRE parameter is specified, the partition must have the requested amount of main storage available before the job can be
executed-N o t e : l f m o r e th a n 1 2 8 f i l e s a r e to b e p r o c e s s e d i n a p a r t i t i o n , m i n i m u m p a r t i t i o n s i z e i s 1 0 K .
SPOOL: SPOOL-NO ensures that the job will not be loaded if spooling is active in that partition. lf SPooL-No is specified, the system prevents the job from being executed when spooling is active. lt is your responsibility to ensure that l/O devices for the job are available and spooling has been stopped for the partition. you may free a device required by a job and stop spooling in a partition by using a STOp command. (See Appendix C for a summary of operator control commands.) SPOOL-NO should be used when a job requires dedicated use of one or more devices being used by spooling.
SPOOL-YES specifies a job that may be run with spooling active. lf this parameter is not g i v e n . S P O O L - Y E S i s a s s u m e d .
1-72
P a g e o f G C 2 1 - 5 1 6 2 - 1 l s s u e d 2 8 S e p t e m b e r 1 9 7 9 B y T N L : G N 2 1 - 5 6 7 4
PARTITION.' This parameter is used to specify the partition in which the job must be e x e c u t e d . l f t h i s p a r a m e t e r i s n o t s p e c i f i e d a n d in p u t s p o o l i n g i s n o t u s e d , t h e s y s t e m a s s u m e s t h e iob can be executed i n a n y p a r t i t i o n . lf P A R T I T I O N i s n o t s p e c i f i e d a n d i n p u t s p o o l i n g i s b e i n g u s e d , t h e jo b i s s c h e d u l e d f o r e x e c u t i o n i n p a r t i t i o n 1 . O n c e a j o b i s p l a c e d o n t h e r e a d e r q u e u e , i t s p a r t i t i o n a s s i g n m e n t c a n b e c h a n g e d t h r o u g h u s e o { i t r e C H A N G E p a r t i t i o n c o m m a n d s .
T h e m e a n i n g o f e a c h p a r t i t i o n c o d e is :
Code Meaning
E x e c u t e j o b in partition 1 E x e c u t e j o b i n p a r t i t i o n 2 E x e c u t e j o b i n p a r t i t i o n 3 E x e c u t e j o b i n p a r t i t i o n 1 o r 2 E x e c u t e j o b i n p a r t i t i o n 1 o r 3 E x e c u t e i o b i n p a r t i t i o n 2 o r 3 E x e c u t e j o b in p a r t i t i o n 1 , 2 , o r 3
y'yote.' When keyword parameters are not specif ied on this statement, comments may not b e g i v e n fo l l o w i n g t h e J O B s t a t e m e n t id e n t i f ie r .
Q C O P Y : T h i s o p t i o n a l p a r a m e t e r (O C O P Y - N O ) p r e v e n t s t h e s p o o l f i l e c o p y p r o g r a m ( $ O C O P Y ) f r o m a c c e s s i n g t h e j o b o n t h e r e a d e r q u e u e . l f O C O P Y - Y E S e i t h e r is s p e c i f i e d or is the default, the spool file copy program can copy the job from the reader queue.
1
2 3 A B
?
D
J O B S t a t e m e n t 1 - 7 2 . 1
T h i s p a g e in t e n t i o n a l l y le f t b l a n k .
1 - 7 2 . 2
The preceding JOB statement causes the following:
Statement read by the spooled reader:
- Priority 1 is assigned to the job on the reader queue and output queues (see note).
- Job is executed in partition 1.
- EXAMPLEl is the jobname o n t h e r e a d e r a n d o u t p u t q u e u e s . Statement is not read by the spooled reader:
- The partition the job executes in is the partition into which the operator loads the job.
- lf spooling is active for the partition into which the job is loaded. priority 1 is assigned to the output queues (see note).
The preceding JOB statement causes the following:
o Statement read by the spooled reader:
- Priority 5 is assigned to the job on the reader queue and output queues (see note).
- Job is executed i n p a r t i t i o n 1 .
- EXAMPLE2 is the jobname on the reader and output queues.
- Prior to the job being initiated,4SK o f m a i n s t o r a g e m u s t b e a v a i l a b l e i n p a r t i t i o n 1 . o Statement not read by spooled reader:
- The partition the job executes in is the partition into which the operator loads the job.
- The job is executed if 48K of main storage is available in the partition into which the job was loaded.
- lf spooling is active for the partition into which the job is loaded, priority 5 is assigned to the output queues (see note).
ffote.' The priority on the output queues can be different for a.job step within the job i f t h e P R I O R I T Y p a r a m e t e r i s s p e c i f i e d o n t h e P R I N T E R a n d / o r P U N C H s t a t e m e n t .
J O B S t a t e m e n t 1 - 7 3
The preceding JOB statement causes the following:
. System with spooling
- The job must be loaded into partition 2.
- Spooling may not be active in partition 2.
- At least 10K of main storage must be available in partition 2.
o System without spooling
- The job must be loaded into partition 2.
- At least 10K of main storage must be available in partition 2.
lf spooling is active in a partition, the JOB statement must be used in that partition.
when jobs are being read onto the reader queue, any errors on the JoB ocL statement cause that job to be assigned a priority of 5. lf the jobname is missing or invalid, the default jobname. JOB, is assigned to that job on the reader queue.
Spool ing Considerations
1 - 7 4
Format