Function The SWITCH statement allows you to modify the external indicators for the partition in which the statement was received. Eight external indicators are assigned to each partition.
External indicators allow you to influence the execution of your programs from an external source. The eight external indicators, for each partition, are set off during lPL.
l f a S W I T C H s t a t e m e n t s e t s a n in d i c a t o r o n i n a p a r t i t i o n , i t r e m a i n s o n u n t i l o n e o f t h e f o l l o w i n g o c c u r s :
. Another swlTCH statement sets it off.
o A JOB statement is received in the partition.
o A /. statement is received in the partition, in job mode.
o A n I P L is p e r f o r m e d a g a i n .
Placement The SWITCH statement can be placed anywhere among the OCL statements. Only one SWITCH statement is allowed between the LOAD or CALL and RUN statements.
Format // SWITCH indicator-settings
Contents Indicator-settings: The indicator-settings parameter is a code that consists of I characters, one for each of the eight external indicators. The first, or leftmost, character gives the setting of external indicator 1; the second character gives the setting of external indicator 2 ; a n d s o o n .
The code must always contain 8 characters. For each external indicator, one of the following characters must be used:
Character Meaning
Set the external indicator off.
Set the external indicator on.
Leave the external indicator as it is.
S W I T C H S t a t e m e n t 1 - 9 3
E x a m p l e
Spool ing Considerations
External Indicator
1 2 3 4 5 6 7 8 N o n e
T h e c o d e 1 X 0 1 1 O X X w o u l d c a u s e t h e f o l l o w i n g r e s u l t s :
Result Set on Unaffected Set off Set on Set on Set off Unaffected Unaffected
't-94
/& Statement
Function /& statements are used as a precautionary measure. Placed at the end of your OCL for a job step, a /& statement signals the system that OCL statements for a new job dtep are coming. lt prevents OCL for the next job step from being read as a part of the pre-ceding set of statements or data. Any attempt to read more data from that device will be blocked. This statement terminates a step mode flush.
Placement /& statements are not required. lt is recommended. however, that you use them as the last statement in each of the sets of OCL statements for your programs. They are not allowed in a procedure.
Format Contents
Spooling Considerations None
/&
None (Comments may be entered starting in column 3; however, this statement requires special consideration when used with the copy/dump program ($COPY). For more information regarding these special considerations, refer to Card lnput Considerations, under Copy/Dump Programl.
/& Statement 1-95
Placement
Format Contents
Spooling Considerations
T h i s s t a t e m e n t i s a j o b s t r e a m d e l i m i t e r t h a t h a s t h e f o l l o w i n g t h r e e f u n c t i o n s : A /. acts as a delimiter between jobs. rt causes end of job and prevents the reading of more OCL for the job.
With spooling active, two consecutive /. statements indicate the end of the spooled input job stream.
With spooling inactive, this statement can be used to end job mode and return to step mode. lt causes end of job in the partition in which the statement was received.
How this statement is used determines where it is placed in a job stream (see examples).
It is not allowed in a procedure.
None (comments may begin in position 3.)
Two consecutive /. statements must be used to indicate the end of the spooled input job slream.
A /. statement may be used to derimit jobs in a job stream. when a job being praced in the reader queue is not delimited by a /. statement, the input spooling routine generates a /' statement as the last statement for the job in the gueue. This statement may contain extraneous characters following the /. when the system history area is displayed or printed, or when the statement is logged on the log device for the partition.
some system service programs ($coPY for example) do not recognize a /. statement with comments or extraneous characters as an end of file indicator unless the statement is read from the system input device. Also, because /. statements in the reader queue may have extraneous characters following the /. delimiter. these programs should nor attempt to read data from the reader queue unless the spooled reader is also the system input device for the partition in which that program is executing.
1-96
The following examples show how the /. statement can be used.
l. When used as a delimiter between jobs:
/ / J O B 1 J O B
/ / S T E P A L O A D P R O G A , R l / / R U N
Data /&
/ / S T E P B L O A D P R O G B , R l / / R U N
Data /&
/. This indicates the end of JOBI and prevents the reading of more OCL for J O B l . l f a n y jo b s t e p s i n J O B l h a d b e e n c a n c e l e d , t h e / . i n d i c a t e s t h e e n d o f the job. lf this statement were not in a job stream. the following invalid JOB statement, the LOAD statement, and all other statements up to the next /. or valid JOB statement would have been read as part of the OCL for JOBl.
//JAB2JOB
/ / S T E P A L O A D P R O G C , R l / / R U N
2. When used to indicate end of spooled data:
/ / J O B l J O B
/ / S T E P A L O A D P R O G A , R I / / R U N
I
Data
t&
/ / S T E P B L O A D P R O G B , R l / / R U N
I
Data
//JOB2 JOB
/ / S T E P A L O A D P R O G C , R l / / R U N
Data l&
/ / S T E P B L O A D P R O G D , R l (
I
/ / R U N Data /*
I I
',' I Indicates end of spooled input
t . I
/. Statement 1-97
3' when used to end job mode and return to step mode (nonspoored systems onry):
/ / J O B I J O B SPOOL-NO,PARTITION.l,COR E . I 2 / / S T E P A L O A D P R O G A . R l
(
I
/ / R U N Data
/&
/ / S T E P B L O A D P R O G B , R l / / R U N
I
Data
/. Ends job mode. Begin step mode.
/ / L O A D P R O G C , R l / / R U N
*(Comment) Statements
Function Comment statements are commonly used to explain the jobs or give the operator instruc-tions. A comment statement can also be used to cause a second record to be written to the SHA following the comment. This record, called a time stamp, contains the system date and the time of day (if timer support was generated). Comment statements are printed along with the other OCL statements.
Placement You can include, among OCL statements, special statements that contain only comments.
C o m m e n t s t a t e m e n t s m u s t c o n t a i n a n a s t e r i s k ( * ) i n c o l u m n 1 . l f y o u i n c l u d e t h e w o r d T I M E w i t h a n " ( * T I M E ) , th e s y s t e m w r i t e s t h e c o m m e n t s t a t e m e n t p l u s a t i m e s t a m p i n the system history area.
Format
Comment statements can be placed anywhere among the OCL statements in either a job stream or a procedure. Comment statements are never displayed on the CRT but are printed if LOG is assigned to a printer (1403 or 3284\ tor the partition in which the comment statement was used and the printer is not allocated to a partition.
* c o m m e n t , o r * T I M E
c o m m e n t
Contents The comment can be any combination of words and characters. The requirements are t h a t t h e a s t e r i s k ( * ) b e in c o l u m n 1 , a n d if s p e c i f i e d , T I M E m u s t s t a r t in c o l u m n 2 . The following example shows the format of the *TIME
statement and the time-stamp record as it appears in the SHA.
2 * T I M E C O M M E N T F R O M P A R T I T I O N 2 2 0 4 / 2 6 / 7 8 0 0 . 0 0 . 5 4
This statement was generated by the user.
This statement was inserted into the SHA by the system.
Spooling Considerations None
@ o o o
* ( C o m m e n t ) Statements 1-99
Placement
Format Contents
Spool ing Considerations
The /* statement is not a true ocL statement but is used to indicate the end of a data f il e .
one /* should be used as the rast card of an input data fire or program deck. with the exception of card utilities, two consecutive /* statements wilr cause an error message.
None (Comments may be entered starting in column 3; however, this statement requires special consideration when used with the copy/dump program ($COpy). For more infor.
mation regarding these special considerations, refer to Card lnput considerations, under Copy/Dump Program.l
None
1 - 1 0 0
Part2. System Concepts and Facilities
P a r t 2 . S v s t e m C o n c e p t s a n d F a c i l i t i e s 2 - 1
2-2