Function The LOG statement is used to perform two functions:
o Change the system log device for a partition.
. Control end-of-job page ejection on the log device.
System Log Device
During system generation, a system log device is established for each partition. When a LOG statement is used, the device specified as the system log device remains in effect for the partition until another LOG statement is read or until IPL is performed. The log device applies only to the partition in which the LOG statement is processed.
The following information isnor logged on the printer, but itis logged in the system h i s t o r y a r e a ( S H A ) :
o Responses to ERP (error recovery procedures) messages o Responses to EJ/ES messages
o Spooling messages and responses o Volume recognition facility messages
. occ
. OCC diagnostics
o Any ERP message received while a printer ERP message is active
o Partition identification on OCL statements and control statements for system service programs.
lf logging of the above information is required, you should assign the log device only to the CRT and periodically print the contents of the system history area using the system history area display program ($HIST). See Sysfem Service Programs in Part 4 for a de-scription of $H lST.
Logging to the SHA
All system messages and OCL statements are logged to an area on the system pack called the SHA (system history area).
Note: You may print the SHA or copy the SHA to a device independent file using
$ H l S T . A l s o , y o u m a y d i s p l a y t h e S H A o n t h e d i s p l a y s c r e e n u s i n g t h e D I S P L A Y
command. See Sysfem Service Programs in Part 4Ior a description of $HlST, or Appendix C for a summary of the operator control commands.
L O G S t a t e m e n t 1 - 7 9
Logging to the CRT
System messages that require a response and informational messages are logged to the CRT independent of the assigned log device. The only effect of a ll LOG CONSOLE statement is that logging to the printer is stopped.
Logging to the 3294
lf the 3284 is assigned as the log device and is not assigned to a partition, system messages, OCL, and control statements are logged to the 32g4.
Logging to the l4O3
System messages, ocL, and control statements are logged to the 1403 if the 1403 is assigned as the system log device, if the 1403 is nof assigned to a partition, and if one of the following conditions is met:
o Print spooling is neither active nor using the 1403. In this case, OCL statements and messages are logged directly to the 1403.
o Print spooling is active (intercepting print requests). In this case, OCL statements anct system messages are logged to the printer queue.
Controlling page Ejection
The LOG statement is used to control page ejection that occurs before ES and EJ and after EJ' The EJECT and NOEJECT modes remain in effect for any log device until another LOG statement is read, or until an lpL is performed.
Placement You can use the LOG statement within any of the sets of OCL statements for your job steps. ln a procedure, it must precede the RUN statement.
F o r m a t l l L } G d e v i c e l , m o d e ] or
// LOG ,mode
1-80
Contents The following codes can be used as parameters.
Device Meaning
CONSOLE Log to the CRT and the system history area.
1403 Log to the CRT, the 1403 printer, and the system history area.
3284 Log to the CRT. the 3284 printer, and the system history area.
The log device is not changed.
Mode Meaning
EJECT Eject a page before ES and EJ and after EJ. lf no mode is specified, E J E C T i s a s s u m e d .
NOEJECT Do not eject a page before ES and EJ and after EJ.
Spooling Considerations When 1403 printed output is being spooled, and the system log device has been assigned to the 1403 printer. all system messages that would normally be logged on the 1403 are placed in the spooled print f ile. When the spooled output is printed, the system messages are printed, along with the job steps'output. When spooling 1403 output, a page eject occurs at the start of every job step's printed output, regardless of the mode specified on the LOG statement.
L O G S t a t e m e n t 1 - 8 1
NOHALT Statement F u n c t i o n
Placement
F o r m a t
T h e N O H A L T O C L s t a t e m e n t is u s e d to c a n c e l th e h a l t mode established b y a H A L T O C L statement. lt can also be used to establish a severity code for system messages to allow t h e s y s t e m to s e l e c t d e f a u l t o p t i o n s f o r s y s t e m m e s s a g e s . T h e N O H A L T O C L s t a t e m e n t d o e s n o t o v e r r i d e th e h a l t m o d e e s t a b l i s h e d b y t h e H A L T c o m m a n d . c o m m a n d h a l t m o d e i s a l w a y s p r e v a l e n t (s e e c h a r t b e l o w ) .
T h e N O H A L T O C L s t a t e m e n t c h a n g e s t h e h a l t m o d e f o r t h e p a r t i t i o n i n w h i c h i t w a s r e c e i v e d . A N O H A L T O C L s t a t e m e n t ta k e s effect immediately and lasts until a HALT O C L s t a t e m e n t is r e c e i v e d , a n o t h e r N O H A L T O C L s t a t e m e n t m o d i f i e s th e s e v e r i t y co d e , I P L i s p e r f o r m e d , o r e n d o f j o b o c c u r s . ( A t I P L the system defaults to nohalt mode, with n o s e v e r i t y c o d e . ) W h e n t h e n o h a l t m o d e i s r e s e t a t e n d o f j o b , the system returns to the I P L n o h a l t m o d e o r t h e m o d e e s t a b l i s h e d b y t h e l a s t H A L T o r N o H A L T c o m m a n d r e -c e i v e d b y t h e p a r t i t i o n . T h e f o l l o w i n g -c h a r t s h o w s the -conditions resulting when both O C L a n d c o m m a n d s a r e u s e d :
N O H A L T
o c L
H A L T
o c L
N O H A L T c o m m a n d
N O H A L T H A L T
H A L T u o m m a n d
H A L T ' H A L T
t
" " , r
t " * * o f j o b m e s s a g e s , e n d o f j o b s t e p m e s s a g e s , a n d s y s t e m m e s s a g e s w i t h n o s e v e r i t y d e f a u l t s or with severity c o d e s g r e a t e r th a n the current severitv s e t t i n g .
F o r a s u m m a r y o f O p e r a t o r C o n t r o l C o m m a n d s , s e e A p p e n d i x C .
A N o H A L T s t a t e m e n t c a n b e p l a c e d a n y w h e r e a m o n g t h e o c l - s t a t e m e n t s . l f a p r o c e -d u r e it m u s t p r e c e -d e t h e R U N s t a t e m e n t .
/ / N O H A L T S E V E R I T Y - c o d e
Contents
S p o o l i n g C o n s i d e r a t i o n s
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 T h e N O H A L T s t a t e m e n t , w i t h o r w i t h o u t t h e S E V E R I T Y p a r a m e t e r , s u p p r e s s e s t h e message at end of iob step and/or end of job.
SEVERITY: This parameter is used to indicate the severity code of messages that the s y s t e m is a l l o w e d to s e l e c t d e f a u l t o p t i o n s f o r . l f t h e S E V E R I T Y p a r a m e t e r i s n o t s p e c i -fied, the operator must respond to all system messages, except informational, end of job step and/or end of job messages. The code must be one of the following:
1 , 2 , 4 , 8 - T h e s y s t e m s e l e c t s t h e d e f a u l t o p t i o n f o r s y s t e m m e s s a g e s o f a s e v e r i t y l e s s than or equal to the code indicated. Severity codes and defaults are assigned to most system messages and cannot be altered. lf the severity assigned to a system message is g r e a t e r t h a n t h e s e v e r i t y in d i c a t e d in t h e N O H A L T s t a t e m e n t , t h e s y s t e m s t o p s , w a i t i n g for your response. lf the severity assigned to the message is equal to or less than the severitV indicated in the NOHALT statement, the system selects the default option for the system message and processing continues. lf the default option selected by the system is a 2 or a 3, the end of job message is suppressed. The severity code does not affect s y s t e m m e s s a g e s h a v i n g n o d e f a u l t o p t i o n s o r r e q u i r i n g o p e r a t o r in t e r v e n t i o n . S e v e r i t y code 1 is the least severe, severity code 8 is the most severe. Severity codes are reset to no severity at end of job. For more information on system messages and severity codes, see IBM System/3 Model l5 System Messages, GC21-5076.
y ' V o t e ; H a l t s d i s p l a y e d i n t h e m e s s a g e d i s p l a y u n i t a r e n o t a f f e c t e d b y t h e S E V E R l T Y para meter.
N o n e
N O H A L T S l a l e m e n t 1 - 8 3
F u n c t i o n
Placement
Format Contents
S p o o l i n g C o n s i d e r a t i o n s
The PAUSE statement causes a system message (message 90 if before a LOAD or GALL s t a t e m e n U m e s s a g e 9 1 i f b e t w e e n a L O A D o r C A L L and a RUN statement). l t i s u s u a l l y used to give the operator time to prepare for the next program; for exampre, mount a different data module or insert special forms into the printer. Comment statements that give the operator instructions usually precede pAUSE statements (see comment Statementl .
W h e n t h e o p e r a t o r i s r e a d y , t h e p a r t i t i o n i n w h i c h th e P A U S E s t a t e m e n t w a s r e c e i v e d i s restarted by responding to the message. The system then continues reading the ocL statements that follow the pAUSE statement.
The PAUSE statement is the onry ocL statement rogged on the dispray screen; therefore, i t m a y b e u s e d t o s u p p l y i n f o r m a t i o n t o t h e o p e r a t o r .
PAUSE statements can be placed anywhere among the ocL statements. In a procedure, a PAUSE statement must precede the RUN statement.
// PAUSE
N o n e (c o m m e n t s m a y b e e n t e r e d a f t e r th e b l a n k fo l l o w i n g p A U S E ) N o n e