Session And Window Naming - HP NonStop SSH 544701-014 Reference Manual

The current setting is shown by INFO STN.

Session and Window Naming

Session (and dynamic window) names always began at 0000 when STN was started. This resulted in the same session
name being used for different STN processes or for restarts of an STN process. The session names should be unique.
Starting with SPR T0801^ABE, a new optional naming scheme was introduced for sessions and dynamic windows. The
default still uses names like #ZWN0001.
A related new feature provides for the pooling of window names over multiple STN processes, and over restarts of STN
processes.
PARAM GWN^TEMPLATE #AAAnnn
GWN^TEMPLATE allows the format of session names to be configured. Window names have the syntax:
#AAAnnn
# must appear as the first char-
AAA alphabetic prefix, 1 to 4 letters.
nnn numeric suffix, 2 to 5 decimal digits.
Total must be 4 to 8 characters including "#".
Examples:
#TERM000 increments to #TERM999, then back to #TERM000. 1,000 unique names.
#P77 increments to #P99 then back to #P00. Shortest possible name. 100 unique names.
#AB12345 cycles to #AB99999 then back to #AB00000. 100,000 unique names (maximum allowed).
If GWN^TEMPLATE is not used, or does not follow the above rules, a default of #ZWN0001 is used, which is
compatible with STN B19 and earlier.
GWN^TEMPLATE defines both the format of the name and the starting window name. As sessions are started, the
numeric suffix is incremented until it reaches all nines, then the next window name wraps back to all zeroes. Using a
short numeric suffix makes typing window names easier. Using a longer numeric suffix allows for more sessions before
a window name is reused.
GWN^TEMPLATE may be used with or without GWN^FILE.
PARAM GWN^INITIAL RANDOM
If this param is present and is set to the value RANDOM, the initial value is randomly computed from the microsecond
clock. Otherwise, the number in GWN^TEMPLATE, if present, is used, or else the default of 0001.
GWN^INITIAL may be used with or without GWN^FILE.
PARAM GWN^FILE <filename>
GWN^FILE names a central disc file where the next window name is stored. Normally, all STN processes would share
the same file by using the same PARAM GWN^FILE value.
<filename> must name a disc file.
If the file does not exist, it is created as an unstructured disc file, code 1107, and initialized using GWN^TEMPLATE
and GWN^INITIAL. If it cannot be created or written, the default of #ZWN0001 is used.
If the file exists, it is validated as containing a valid GWN record. If the GWN record is valid, STN allocates an initial
block of window names as described below. The window name stored in the file overrides any GWN^TEMPLATE.
HP NonStop SSH Reference Manual
STN Reference • 253