Gwn Related Stncom Commands - HP NonStop SSH 544701-014 Reference Manual

If the file exists but an error occurs while opening or reading the file, or the file does not contain valid GWN data, STN
closes the file, generates an EMS warning and runs without GWN^FILE for the duration of the STN process. No
recovery is attempted. If it cannot be created or written, the default of #ZWN0001 is used.
If <filename> is OFF, or the PARAM is omitted, then the default of #ZWN0001 is used.
PARAM GWN^BLOCKSIZE <nnn>
When GWN^FILE is used, GWN operates by allocating a block of consecutively numbered window names at a time.
This allows multiple STN processes to use the same range of window names without duplicating any names. It also
allows a restarted STN process to avoid duplicating names previously used.
GWN^BLOCKSIZE specifies the number of window names to be allocated in each block, in the range 10-1000. If
GWN^BLOCKSIZE is not specified, or contains an illegal value, a default or 25 is used.
Allocation works as follows:
1. STN reads GWN file (with locking) to get the next window name.
2. This window name and the next <blocksize>-1 consecutive window names are reserved for use by this STN
process.
3. STN adds <blocksize> to the numeric portion of the window name and rewrites (with unlock) GWN file.
4. STN then uses the reserved window names for new sessions. When the reserved list is exhausted, another
allocation is performed.
5. If any error occurs reading or writing GWN^FILE, the file is closed and the default #ZWN0001 is used for the
duration of the STN process.
GWN^BLOCKSIZE is automatically reduced if necessary so that is does not exceed a tenth of the numeric range defined
by GWN^TEMPLATE. For example, with GWN^TEMPLATE #T00, there are only 100 names in the range, so the
maximum is 10. For #PTY0000, the maximum is 1000.
With this allocation scheme, there may be some gaps in window numbering, but there will generally be no duplication,
which can simplify tracking of windows.

GWN Related STNCOM Commands

INFO STN
Displays GWN parameters.
DYN_WIN_MAX
The existing DYN_WIN_MAX command is generally superseded by the features of GWN^TEMPLATE, but it is still
allowed.
DYN_WIN_MAX nnn
nnn is the maximum number of window names, including zero (0). nnn must be in the range 100 to 100000,
default 100000. DYN_WIN_MAX may be used to reduce the number of windows allowed by
GWN^TEMPLATE. For example:
PARAM GWN^TEMPLATE #Z0000
STNCOM $STN ; DYN_WIN_MAX 250
cycles from #Z0000 to #Z0249, then back to #Z0000.
GWN
STNCOM displays the GWN filename and details about the window name and option and optionally a new block of
names.
254 • STN Reference
HP NonStop SSH Reference Manual