The First Failure Support Technology/2 (FFST for OS/2) program captures error data at the point of occurrence, provides immediate problem notification to predefined locations, and furnishes unique error code identification. Because it remains passive until a software error is detected, its impact on system performance is minimal.
FFST for OS/2 provides the following functions:
Currently, FFST for OS/2 is accessed by LAN Adapter and Protocol Support (to log messages only) and by DB2 (to log error data and generic alerts).
The FFST for OS/2 program group must exist on your Desktop Manager window. If it has not already been added, type the following command at the OS/2 command line:
EPWINST
This command presents you with a series of windows that allow you to specify the FFST for OS/2 configuration parameters and enter the workstation parameters. (To reset the parameters to the default values, select Reset.) After specifying the appropriate parameters in each window, select OK.
See "Configuring and Enabling the FFST for OS/2 Utility" for details on the FFST for OS/2 configuration parameters.
You can modify FFST for OS/2 operations and configuration with the epw command. For example, you can:
FFST for OS/2 is enabled by the presence of the epw command in the CONFIG.SYS file. All of the command parameters are optional and may be specified in any combination or order.
This command operates in two modes:
The syntax of the FFST for OS/2 epw command follows:
+---------------------------------------------------+
V |
>>-epw----+------------------------------------------------++--><
+-+-on--+----------------------------------------+
| +-off-+ |
+-msg--=--+-on--+--------------------------------+
| +-off-+ |
+-maxsysdump--=--nn------------------------------+
+-maxapldump--=--nn------------------------------+
+-sysdumppath--=--+--------+-+-------+-----------+
| +-drive:-+ +-\path-+ |
+-apldumppath--=--+--------+-+-------+-----------+
| +-drive:-+ +-\path-+ |
+-mlogname--=--+--------+-+-------+-+-----------++
+-drive:-+ +-\path-+ +-\filename-+
(This parameter is the default when you type EPW without specifying any parameters.)
Notes:
Notes:
Notes:
Notes:
Notes:
If a directory is not specified, the default directory will be used. The default directory is OS2\SYSTEM.
If a file name is not specified, the default file name OS2MLOG.DAT will be used.
The first invocation of the epw command defines the values that will be used until the machine is rebooted or the values are reset.
For example, assume you enabled FFST for OS/2 by placing the following line in the CONFIG.SYS file:
RUN=C:\OS2\EPW.EXE MAXAPLDUMP=75
If you later disable FFST for OS/2 by issuing EPW OFF, the value for MAXAPLDUMP in a subsequent EPW ON command will be 75 rather than 32.
This applies to all of the epw keywords listed above.
Error records logged through FFST for OS/2 are recorded in the OS/2 System Error Log (SYSLOG). This is the same log to which the OS/2 logging facility writes error records. Refer to "Using the OS/2 Logging Facility" for information about the syslog command. (You can also select System Error Log in the FFST for OS/2 program group window to access this log.)
DB2 will always write a symptom record when using any of the FFST for OS/2 services. The symptom record includes:
This string is generated in the following format: PIDS/ccccccccc LVLS/lll RIDS/ssssssss PCSS/nnnn PRCS/pppppppp PRCS/scscscsc MS/mnmnmnmn
In order to route generic alerts over an SNA session to a host (such as SystemView) or to a LAN alert collection facility, you must enable the Generic Alert Router function of the FFST for OS/2 program, and specify a destination. To do this, use the epwrout command.
Its syntax is as follows:
epwrout [Destination] [Option]
The parameters of this command are optional and positional. If only one parameter is specified, it is assumed to be the Destination parameter. This parameter is a numeric value to specify an action, and supports the following values:
The Option parameter is needed only if the destination value is "2". It specifies the LAN adapter used to route alerts. If it is not specified, its value is assumed to be "0", and adapter 0 will be used. Values 0 through n are supported, where n is the number of LAN adapters available for your system. (The first LAN adapter is identified as Adapter 0.)
Start the router by placing a RUN= statement in the CONFIG.SYS file, or with the start or detach commands at the command line.
For example, to route the alerts to a dump file called EPWALERT.DMP, do one of the following: