Syntax
STNINFO expression variableParameters
StnInfo can be abbreviated as SI.
expression
The Windows username or ROC alias, or the MCP-based station or printer name to be validated
variable
A string variable to receive the requested information. This variable must have a minimum length of 79.
Description
For systems-based on the MCP platform
The StnInfo command validates a station or printer name. It accesses the COMS configuration file and stores station or printer information in a specified qualifier.
Glb.Status is set to indicate the validity of the supplied station or printer name. It is set to “*****” if the station or printer name is not valid.
Station information recalled includes the values shown in the following table and in the listed sequence.
Description | Value | Length |
|---|---|---|
| Terminal type | TP or VD | 2 |
| Model | As declared in the COMS configuration file | 10 |
| Associated printer or Printer host is recalled | VD (associated printer) or TP (printer host) | 17 |
| Not used |
| 50 |
For systems-based on the Windows operating systems
The StnInfo logic command obtains information about a username in the LINCIINET file or a ROC alias.
The StnInfo logic command first examines the LINCIINET file for the specified identifier. If it is found there (indicating that it is a username), information is returned in the specified variable, in the listed sequence as in the following table.
Description | Value | Length |
|---|---|---|
| Type | VD | 2 |
| Not used |
| 10 |
| Printer | Associated printer | 17 |
| Privilege | Glb.Priv built-in segment attribute value | 4 |
If the specified identifier is not found in the LINCIINET file, the StnInfo logic command then proceeds to examine the ROC aliases. If it is a valid ROC alias, information is returned in the specified variable, in the listed sequence as in the following table.
Description | Value | Length |
|---|---|---|
| Type | TP | 2 |
| Not used |
| 27 |
| Alias | Full ROC Alias | 50 |
If the specified identifier is not found in the LINCIINET file, and it is not a valid ROC alias, the Glb.Status built-in segment attribute is set to "*****".
Note: In Debugger, when the StnInfo verb is found in the following condition, Debugger shows a message to indicate that StnInfo is not implemented:
Windows system without ROC installed
MCP system
While debugging a system for an Windows system with ROC installed, StnInfo works the same way as the generated system.