The EXT command generates an external interrupt (the virtual INTERRUPT key is pressed).
Descriptive
Diagram
¬¬¬¬ ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
None.
Example 1:
Generate an external interrupt.
HHC00013I Herc command: 'ext'
HHC02228I Key 'interrupt' pressed
Figure 127: EXT command
The F{+/-} command is used to mark storage frames as usable or unusable.
Descriptive
- addr
Diagram
Êʬ¬¬ F ¬¬¬§¬¬¬ + ¬¬¬§¬¬¬ addr ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
-
+
Mark storage frame as usable.
-
Mark storage frame as unusable.
addr
The address of the storage frame that has to be marked usable or unusable.
Example 1:
Mark frame at address x’01000000’ as unusable.
HHC00013I Herc command: 'f- 01000000'
HHC02204I frame 01000000 set to unusable
Figure 128: F{-} command
Powered by Tizra® |
The EXT command generates an external interrupt (the virtual INTERRUPT key is pressed).
Descriptive
Diagram
¬¬¬¬ ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
None.
Example 1:
Generate an external interrupt.
HHC00013I Herc command: 'ext'
HHC02228I Key 'interrupt' pressed
Figure 127: EXT command
The F{+/-} command is used to mark storage frames as usable or unusable.
Descriptive
- addr
Diagram
Êʬ¬¬ F ¬¬¬§¬¬¬ + ¬¬¬§¬¬¬ addr ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
-
+
Mark storage frame as usable.
-
Mark storage frame as unusable.
addr
The address of the storage frame that has to be marked usable or unusable.
Example 1:
Mark frame at address x’01000000’ as unusable.
HHC00013I Herc command: 'f- 01000000'
HHC02204I frame 01000000 set to unusable
Figure 128: F{-} command
The EXIT command (see also the QUIT command) initiates the Hercules shutdown. It terminates all
threads, detaches all channels and devices and releases the configuration. Finally it terminates the
emulator. If the guest OS has enabled “Signal Shutdown” then a signal shutdown request is sent to the
guest OS and termination will begin after the guest OS has shutdown.
The EXIT command acts different depending on how Hercules was built. If Hercules was not compiled
with the option 'OPTION_SHUTDOWN_CONFIRMATION' then the command acts as described above.
If Hercules however was built with option 'OPTION_SHUTDOWN_CONFIRMATION' then the following
special processing for terminating the emulator takes place.
If EXIT is entered and the command level is not set to 'developer', 'debug' or 'all' then EXIT will first check
that all online CPUs are stopped. If any CPU is not in the stopped state message HHC00069I is displayed
indicating the number of CPUs still running.
Message HHC02266A follows that prompts for confirmation by entering a second EXIT command within a
certain time period (default 10 seconds) to start termination of the emulator. If the time period has expired
then the process starts over. This is to prevent an inadvertent shutdown of Hercules while still a guest OS
is running.
The time period for the second EXIT command can be set to another value by using the 'QUITMOUT'
console command or system parameter.
If all processors are stopped or the command level is set to "developer", "debug" or "all" then quit stops
Hercules immediately. 'EXIT FORCE' will also terminate the emulator immediately without any further
checks.
Descriptive
[]
Diagram
Êʬ¬¬ ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
FORCE
Terminate the emulator immediately.
Example 1:
Initiate the Hercules shutdown.
HHC00013I Herc command: 'exit'
HHC00069I Guest is not quiesced; there are 8 CPUs active
HHC02266A Reenter command 'exit' again within 10 seconds to execute
HHC00013I Herc command: 'exit'
HHC01420I Begin Hercules shutdown
HHC01421I Releasing configuration
.
several lines not displayed
.
HHC01422I Configuration release complete
HHC01423I Calling termination routines
.
several lines not displayed
.
HHC02103I Logger: logger thread terminating
HHC01412I Hercules terminated
Figure 125: EXIT command
Example 2:
Initiate an immediate Hercules shutdown.
HHC00013I Herc command: 'exit force'
HHC01420I Begin Hercules shutdown
HHC01421I Releasing configuration
.
several lines not displayed
.
HHC01422I Configuration release complete
HHC01423I Calling termination routines
.
several lines not displayed
.
HHC02103I Logger: logger thread terminating
HHC01412I Hercules terminated
Figure 126: EXIT FORCE command
Powered by Tizra® |
The EXIT command (see also the QUIT command) initiates the Hercules shutdown. It terminates all
threads, detaches all channels and devices and releases the configuration. Finally it terminates the
emulator. If the guest OS has enabled “Signal Shutdown” then a signal shutdown request is sent to the
guest OS and termination will begin after the guest OS has shutdown.
The EXIT command acts different depending on how Hercules was built. If Hercules was not compiled
with the option 'OPTION_SHUTDOWN_CONFIRMATION' then the command acts as described above.
If Hercules however was built with option 'OPTION_SHUTDOWN_CONFIRMATION' then the following
special processing for terminating the emulator takes place.
If EXIT is entered and the command level is not set to 'developer', 'debug' or 'all' then EXIT will first check
that all online CPUs are stopped. If any CPU is not in the stopped state message HHC00069I is displayed
indicating the number of CPUs still running.
Message HHC02266A follows that prompts for confirmation by entering a second EXIT command within a
certain time period (default 10 seconds) to start termination of the emulator. If the time period has expired
then the process starts over. This is to prevent an inadvertent shutdown of Hercules while still a guest OS
is running.
The time period for the second EXIT command can be set to another value by using the 'QUITMOUT'
console command or system parameter.
If all processors are stopped or the command level is set to "developer", "debug" or "all" then quit stops
Hercules immediately. 'EXIT FORCE' will also terminate the emulator immediately without any further
checks.
Descriptive
[]
Diagram
Êʬ¬¬ ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
FORCE
Terminate the emulator immediately.
Example 1:
Initiate the Hercules shutdown.
HHC00013I Herc command: 'exit'
HHC00069I Guest is not quiesced; there are 8 CPUs active
HHC02266A Reenter command 'exit' again within 10 seconds to execute
HHC00013I Herc command: 'exit'
HHC01420I Begin Hercules shutdown
HHC01421I Releasing configuration
.
several lines not displayed
.
HHC01422I Configuration release complete
HHC01423I Calling termination routines
.
several lines not displayed
.
HHC02103I Logger: logger thread terminating
HHC01412I Hercules terminated
Figure 125: EXIT command
Example 2:
Initiate an immediate Hercules shutdown.
HHC00013I Herc command: 'exit force'
HHC01420I Begin Hercules shutdown
HHC01421I Releasing configuration
.
several lines not displayed
.
HHC01422I Configuration release complete
HHC01423I Calling termination routines
.
several lines not displayed
.
HHC02103I Logger: logger thread terminating
HHC01412I Hercules terminated
Figure 126: EXIT FORCE command
The FCB command is used to load a new FCB image or set the LPI (lines per inch) and LPP (lines per
page) settings for a given 1403 or 3211 printer. Without arguments the FCB command displays the
current settings for the printer.
To change settings, the printer must be stopped first ("STOP devaddr") and then started again ("START
devaddr").
Descriptive
icenum lpilpp]
]
Diagram
¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
lpi lpi
ʬ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬ÊÍ
devicenum
This is the device number of the printer for which the current settings have to be
listed or changed.
LPI=
Specifies the number of lines per inch. The value of lpi must be 6 or 8.
LPP=
Specifies the number of lines per page. The value of lpp must be numeric but is not
otherwise checked. Any number of lines per page is allowed.
FCB=
FCB= specifies an new FCB image to use for the printer. The argument must be
given in the form l1:c1, ...,;l12:c12 where 'l' and 'c' are both numeric. The value of 'l'
is the line number and the value of 'c' is the assigned channel. There is a maxi-
mum of 12 'l:c' pairs allowed.
Example 1:
Display the current FCB for the printer with device address 000E.
HHC00013I Herc command: 'fcb 000e'
HHC02210I 0:000E lpi=6 index=0 lpp=66 fcb=1:1,7:2,13:3,19:4,...,43:8,49:10,55:11,61:12,63:9
Figure 129: FCB command (display current FCB)
Example 2:
Stop the printer with device address 000E. Set lines per inch to 6, lines per page to 66 and load a new
FCB image for the printer. Then start the printer again.
HHC00013I Herc command: 'stop 000e'
HHC02214I 0:000E device stopped
HHC00013I Herc command: 'fcb 000e lpi=6 lpp=66 fcb=1:1,6:2,12:3,18:4,...,48:9,54:10,60:11,66:12'
HHC02210I 0:000E lpi=6 index=0 lpp=66 fcb=1:1,6:2,12:3,18:4,...,48:9,54:10,60:11,66:12
HHC00013I Herc command: 'start 000e'
HHC02214I 0:000E device started
Figure 130: FCB command (load new FCB image)
Powered by Tizra® |
The FCB command is used to load a new FCB image or set the LPI (lines per inch) and LPP (lines per
page) settings for a given 1403 or 3211 printer. Without arguments the FCB command displays the
current settings for the printer.
To change settings, the printer must be stopped first ("STOP devaddr") and then started again ("START
devaddr").
Descriptive
icenum lpilpp]
]
Diagram
¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
lpi lpi
ʬ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬ÊÍ
devicenum
This is the device number of the printer for which the current settings have to be
listed or changed.
LPI=
Specifies the number of lines per inch. The value of lpi must be 6 or 8.
LPP=
Specifies the number of lines per page. The value of lpp must be numeric but is not
otherwise checked. Any number of lines per page is allowed.
FCB=
FCB= specifies an new FCB image to use for the printer. The argument must be
given in the form l1:c1, ...,;l12:c12 where 'l' and 'c' are both numeric. The value of 'l'
is the line number and the value of 'c' is the assigned channel. There is a maxi-
mum of 12 'l:c' pairs allowed.
Example 1:
Display the current FCB for the printer with device address 000E.
HHC00013I Herc command: 'fcb 000e'
HHC02210I 0:000E lpi=6 index=0 lpp=66 fcb=1:1,7:2,13:3,19:4,...,43:8,49:10,55:11,61:12,63:9
Figure 129: FCB command (display current FCB)
Example 2:
Stop the printer with device address 000E. Set lines per inch to 6, lines per page to 66 and load a new
FCB image for the printer. Then start the printer again.
HHC00013I Herc command: 'stop 000e'
HHC02214I 0:000E device stopped
HHC00013I Herc command: 'fcb 000e lpi=6 lpp=66 fcb=1:1,6:2,12:3,18:4,...,48:9,54:10,60:11,66:12'
HHC02210I 0:000E lpi=6 index=0 lpp=66 fcb=1:1,6:2,12:3,18:4,...,48:9,54:10,60:11,66:12
HHC00013I Herc command: 'start 000e'
HHC02214I 0:000E device started
Figure 130: FCB command (load new FCB image)