Abend trap

The VARY TCPIP,tnproc,TELNET,ABENDTRAP,module,rcode,instance command can be used to set up an abend based on the variables specified. Abend trap has three variables:

module is required. It is the module detecting the error. It can have a wildcard value by using asterisk (*) at the end. If a single * is used, any module reporting the specified return code will cause an abend. The module name "OFF" turns off an active trap.

rcode is optional. It is the return code reported and cannot have a wildcard value.

instance is optional. It is the instance of the return code and cannot have a wildcard value.

Below is an example setting the abend trap and then issuing a profile display to verify the trap is set. In the example, when EZBTTRCV reports an error code of 1001, Telnet will issue an abend with reason code '3133'x. The state of the trap changes from "ACTIVE" to "TRIPPED". No more abends will be issued. After being tripped, the abendtrap command must be issued again to activate the trap. While the trap is active, the abend trap can be turned off by specifying "OFF" as the module name. An active trap cannot be changed directly. The current trap must be tripped or turned off before a new command is accepted.

V TCPIP,TCPCS6,T,ABENDTRAP,EZBTTRCV,1001
EZZ6038I TCPCS6 COMMAND ABENDTRAP EZBTTRCV COMPLETE
 
D TCPIP,TCPCS6,T,PROF
EZZ6060I TCPCS6 PROFILE DISPLAY 
  PERSIS   FUNCTION    DIA  SECURITY  TIMERS  MISC                 
 (LMTGQAK)(OATSKQSWHT)(DRF)(PCKLECXN)(IKPSTS)(SMLT)                
  -------  ----------  ---  --------  ------  ----                 
  LM*R*P*  **TSBQ*WHT  TJ*  SSH*ESX*  ***STS  SDD*                 
----- PORT:    23  ACTIVE           PROF: CURR CONNS:      1   
------------------------------------------------------------       
   ABENDTRAP       : EZBTTRCV  1001  FF  ACTIVE
4 OF 4 RECORDS DISPLAYED