Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-160
SSIDTOTEXT Procedure
chars
STRING .EXT:ref:*
contains the resulting displayable representation of ssid. The length of the string is
returned in len. The string will not be longer than 23 characters.
status
INT(32) .EXT:ref:1
contains a status code describing any problem encountered. The codes in the
following list are obtained by examining the two halves of the INT(32) value.
(0,0) - No error.
(0,x) - problem with calling sequence.
x: 29 - required parameter missing
632 - insufficient stack space
(1,x) - error allocating private segment; x is the ALLOCATESEGMENT error code.
(2,x) - problem opening nonresident template file.
x: >0 - file system error code
-1 - file code not 844
-2 - file not disk file
-3 - file not key-sequenced
-4 - file has wrong record size
-5 - file has wrong primary key definition.
(3,x) - error reading nonresident template file; x is the file system error.
(4,0) - invalid value in internal subsystem ID.
(7,x) - error accessing private segment; x is the MOVEX error code.
(8,0) - internal error.
Considerations
The external form of a subsystem ID is:
owner.ss.version or 0.0.0
owner 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.
ss is either the subsystem number or the subsystem name.
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.