10 PROCESSING WORKSTATION NAMES

The routine SGS_WNAME allows the list of workstation names known to SGS, and their associated comments, to be retrieved for processing by your program.

  CALL SGS_WNAME (ROUTIN, I, ISTAT)

where ROUTIN is the name of a subroutine which is to process the names, I is an integer which is also passed your routine, and ISTAT is a status. ROUTIN (which must of course be declared as EXTERNAL) is called once for each workstation in the list with the following arguments:

NAME (CHARACTER) Workstation name     COMMNT (CHARACTER) Associated comment string     I (INTEGER) The value specified in the call to SGS_WNAME     ISTAT (INTEGER) Status return

The character arguments should be declared as assumed length variables and can be up to 255 characters long. The integer argument I can be used for any purpose you wish; a typical use would be to pass a logical unit number to which the routine is to write the workstation names. ISTAT should be set to zero if the routine completes successfully; if any other value is returned SGS_WNAME will abandon processing the list and return immediately to its caller.