Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)

Guardian Procedure Calls Reference Manual—522629-013

14-159

SSIDTOTEXT Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

Considerations

Summary

Converts internal format subsystem ID to external representation.

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

len

INT

contains the 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.

ssid

INT .EXT:ref:6

contains the subsystem ID to be converted to displayable form.

Note. In the TNS/E environment the CEXTDECS file uses the int data type for 32-bit values.

This is a change from the TNS and TNS/R environments where CEXTDECS uses the long

data type for 32-bit values.

#include <cextdecs(SSIDTOTEXT)>

short SSIDTOTEXT (short ssid

,char *chars

,[__int32_t *status ]);

len := SSIDTOTEXT (ssid !i

,chars !o

[,status]); !o