0100 - Data block not aligned on a 2K boundary. 0200 - Data block length not a mUltiple of 8. 0300 - The data block length is not adequate for the amount of information
requested. DIAGNOSE Code X'84' --Directory Update-In-Place I Privilege class B DIAGNOSE Code X'84' enables a class B user to replace certain data in any entry
of the VM/SP directory. The user must specify the directory entry and may
replace the following data:
Logon password
Virtual machine storage size
Maximum virtual machine storage size
Privilege classes
Dispatching priority
Logical editing symbols
Initial program load (IPL) system
IPL parameter data
Account number
Distribution word
User options
Minidisk access mode
Minidisk read, write, or multiple password Options of the SCREEN directory control statement
With the exception of the account number, all changes to the entry take effect the
next time the USERID associated with the entry logs onto VM/SP. The account
number may be updated such that the change (1) takes effect immediately, (2)
takes effect immediately but is temporary lasting only until the USERID is logged
off, or (3) takes effect the next time the USERID associated with the entry is
logged on. DIAGNOSE Code X'84' cannot add new entries to the directory, cannot delete
existing entries, nor can it alter directory user-description statements. It can only
replace existing directory data. Data is replaced in the form of the directory cre­
ated by the directory service program, that is, in VM/SP control blocks.
For a detailed description of the directory data, see the VM / SP Planning Guide and
Reference.
Entry Values: When DIAGNOSE Code X'84' is issued, the Rx register must point
to a variable length parameter list and the Ry register must specify, in bytes, the
length of the list. The list cannot be greater than 112 bytes long or less than zero
bytes. The parameter list contains an area of fixed length followed by an area of
variable length. Data in the fixed-length area identifies the directory entry to be
updated, the password of the USERID associated with the entry, and the data field
to be replaced in the directory entry. The variable-length area contains replace­
ment data for the directory entry. All entries in the parameter list must contain
unpacked, EBCDIC data.
The parameter list is organized as follows:
DIAGNOSE Instruction in a Virtual Machine 267
Operation
Field
Value LOGPASS STORAGE Date
USERID
password fixed-length area
operation
/ /
variable-length area / / I I Fixed-length area USERID password
operation
The USERID of the user whose directory entry is updated. This is an
eight-character, left-justified value and must be padded with blanks.
The current password of the USERID whose directory entry is
updated. This is an eight-character, left-justified value and must be
padded with blanks.
If this field is blank, the update-in-place function is processed in
'testmode'. When the DIAGNOSE is issued in this fashion, the direc­
tory is not updated. 'Testmode' lets you check the syntax of the direc­
tory statements without accessing the directory disk.
An eight-byte, left-justified character string that identifies the data in
the directory entry that is to be replaced. Valid values and the data
that each identifies for replacement are defined in the description of
the variable-length area which follows.
Variable-length area
The following diagram shows for each value of the operation field, (1) the data that
must be in the variable-length area of the parameter list, and (2) the format and
characteristics of the data.
Characteristics/Format
logon password An eight-byte, left-justified value padded with
virtual machine storage
size
blanks.
An eight-byte, left-justified decimal value followed
by the letter K. Pad with blanks following the let­
ter K.
268 VM/SP System Programmer's Guide
Previous Page Next Page