Guardian Procedure Calls Reference Manual

file not key-sequenced-3
file has wrong record size-4
file has wrong primary key definition-5
Error reading nonresident template file; x is the file-system error.(3,x)
Invalid value in internal subsystem ID.(4,0)
Error accessing private segment; x is the MOVEX error code.(7,x)
Internal error.(8,0)
Returned Value
INT
Number of characters placed into chars. Zero is returned if one of the errors (0,29), (4,0), or
(8,0) occurs. Other errors may prevent obtaining the subsystem name, in which case the subsystem
ID is still produced but contains the subsystem number rather than the subsystem name.
Considerations
The external form of a subsystem ID is owner.ss.version or 0.0.0
where:
is 1 to 8 letters, digits, or hyphens, the first of which must be a letter; letters are not upshifted so the end
user must enter owner in the proper case.
owner
is either the subsystem number or the subsystem name.ss
A subsystem number is a string of digits which may be preceded by a minus sign. The value of the number
must be between -32767 and 32767.
A subsystem name is 1 to 8 letters, digits, or hyphens, the first of which must be a letter. Letters are not
upshifted; the end user must enter the subsystem name in the proper case.
is either a string of digits which represents a TOSVERSION-format version (Ann) or a value from 0 to
65535.
version
Examples of subsystem IDs in external form:
HP.PATHWAY.C00
HP.52.0
0.0.0
The 0.0.0 form is used to represent the "null" subsystem ID. Its internal representation is binary
zero. The number of zeros in each field may vary; for example, 000.0.000 is equivalent to 0.0.0.
SSIDTOTEXT Procedure 1389