is the beginning address of the data to be displayed.
is the standard CCW flag field with the suppress incorrect
length indication (5LI) bit on.
is a control byte that indicates the starting output displaY' line= If the high order bit is on, the entire 3270 output display area is erased before the new data is displayed. A
value of X'FF' clears the screen, but writes nothing.
is a two byte field indicating the number of bytes to be displayed. The 3278-2A display console can display a maximum
of 1440 bytes; all other display consoles can display a
maximum of 1760 bytes. When the DIAGNOSE is executed with a valid CCW string, a buffer
(whose length is the number of bytes specified by is built in
free storage. The data pointed to by is loaded into the buffer.
Data chaining may be specified in the CCW to link noncontiguous data
areas; however, command chaining is an end of data indication for the
current buffer. Using the starting output line (ctl) and the number of bytes of
output (count), CP checks that the data will fit on the screen. CP then
does the display. A zero condition code indicates the I/O operation
completed successfully; a nonzero condition code indicates an I/O error
occurred. !Qte: An I/O error occurs when the display screen is placed in MORE status and the PA2 key is pressed to allow screen display. DIAGNOSE Code X'5C' --Error Message Editing
Execution of DIAGNOSE Code X'SC' causes the editing of an error message
according to the user's setting of the EM5G function:
Rx contains the address of the message to be edited.
Ry contains the length of the message to be edited. DMKHVC tests the VMMLEVEL field of the VMBLOK and returns to the caller
with Rx and Ry modified as follows:
, VMMLEVEL 1 Registers on Return I VMMCODE I VMMTEXT 1 Rx Ry 1----1 ON 1 ON 1 no change no change 1----1 ON I OFF 1 no change 10 (length of , , code) I I OFF I ON 1 pointer to text length of text I I part of message alone
1---1 OFF I OFF I N/A 0 200 IBM VM/370 System Programmer's Guide
page of GC20-1807-7 As Updated April 1, 1981 by TNL GN25-0829 DIAGNOSE Code X'SC' does not write the message; it merely
rearranges the startinq pointer and length. For eMS error messages, a
console write is performed following the DIAGNOSE unless Ry is returned
with a value of O. DIAGNOSE Code X'60' -- Determining the Virtual Machine Storage Size Execution of DIAGNOSE Code X'60' allows a virtual machine to determine
its size. On return, the register specified as Rx contains the virtual
machine storage size. DIAGI\JOSE Code X'64' --Finding; Loading!' and
Purging a Named Segment of DIAGNOSE Code X'64' controls the linkage of discontiguous
saved segments. The type of linkage that is performed depends upon the
function subcode in the register specified as Ry. Su bCQg! X'OO' X' 04' X' 08' X'OC' L01DSYS LOADSYS PURGESYS FINDSYS Function
Loads a named segment in shared mode
Loads a named segment in nonshared mode
Releases the named segment from virtual storage
Finds the starting address of the named segment
The register specified as Rx must contain the address of the name of
the segment. The segment name must be 8 bytes long, on a doublevord
boundary, left justified, and padded with blanks. When the LOADSYS diagnose function is executed, CP finds the system name
table entry for the segment and builds the necessary page and swap
tables (two sets one for each processor, when running in attached
processor mode). CP releases all the virtual pages of storage that are
to contain the named segment and then loads the segment in those virtual
pages. When the LOADSYS function is executed, CP expands the virtual
machine size dynamically, if necessary. CP also expands the segment
tables to match any expansion of virtual storage. When LOAD5YS executes successfully, the address of where
segment was loaded is returned in the register specified as
the LOA05Y5 function loads a segment in shared mode,
instruction and branch tracing if either was active.
the named
Rx. When it resets
After a LOA05Y5 function executes, the storage occupied by the named
segment is addressable by the virtual machine, even if that storage is beyond the storage defined for the virtual machine. However, any
storaqe beyond that defined for the virtual machine and below that
defined for the named segment is not addressable. Figure 24 shows the
virtual storage that is addressable before and after the LOAOSY5 function executes.
Part 2. Control Program (CP) 201
Previous Page Next Page