Error scenarios and tracing

If the installed library has not been added to program control, this message appears in the JESMSGLG for the server task:

ICH420I PROGRAM HFISRV FROM LIBRARY HFI.V1R1.SHFIMODA CAUSED
THE ENVIRONMENT TO BECOME UNCONTROLLED.  BPXP014I ENVIRONMENT MUST
BE CONTROLLED FOR SERVER (BPX.SERVER) PROCESSING.

Messages similar to the following might be generated if the user connecting to the server does not have read access to the SHFIMODA library:

ICH408I USER(BILLMAN ) GROUP(USERCOD ) NAME(MANDELLA, BILL ) 218
HFI.V1R1.SHFIMODA CL(DATASET ) VOL(COD035)
INSUFFICIENT ACCESS AUTHORITY
FROM HFI.V1R1.* (G)
ACCESS INTENT(READ ) ACCESS ALLOWED(NONE )
IEC150I 913-38,IFG0194E,BILLMAN,OS390,ISP19502,8E10,COD035,HFI.V1R1.SHFIMODA

Messages on SYSLOG at the time of attempted connection, like the ones that are shown here, are generated when the relevant CONFIG contains an invalid library, or is missing a library from the SPAWN_STEPLIB statement:

IEA995I SYMPTOM DUMP OUTPUT
SYSTEM COMPLETION CODE=EC6  REASON CODE=0B26C032
 TIME=11.37.04  SEQ=38113  CPU=0000  ASID=00ED
 PSW AT TIME OF ERROR  070C3000   82C44CE8  ILC 2  INTC 0D
   NO ACTIVE MODULE FOUND
   NAME=UNKNOWN
   DATA AT PSW  02C44CE2 - C06C18F2  0A0D41B0  D4D0180B
   AR/GR 0: 00000000/00000026_00000648   1: 00000000/00000000_04EC6000
         2: 01FF000C/00000000_0B26C032   3: 00000000/00000000_8286F5B8
         4: 00000000/00000000_00000000   5: 00000000/00000000_00000000
         6: 01FF000C/00000000_00000700   7: 01FF000C/00000000_09BFC3F8
         8: 00000000/00000000_11F4B610   9: 00000000/00000000_163031FF
         A: 00000000/00000000_11F4B610   B: 01FF000C/00000000_7FFC3A00
         C: 00000000/00000000_02C47AC0   D: 00000000/00000000_16302200
         E: 00000000/00000000_82C44CB0   F: 00000000/00000000_0B26C032
 END OF SYMPTOM DUMP
 

If the above are not occurring, but connections are still not successful, shutdown the server and start it again with tracing active. If using the supplied sample, this can be done on the start command. For example, S HFISRV1,TRACE=D. This produces trace entries in the server task on the HFITRACE DD.

A typical trace, with SSL active, before connections are made, looks similar to the one shown here. The main entries of interest confirming start up was successful are highlighted:

2018-11-29-10:54:39.442 [HFISRV:266] Server built at: Nov 29 2018 10:54:03
2018-11-29-10:54:39.601 [HFISRV:952] Record in length:1903
2018-11-29-10:54:39.601 [HFISRV:969] Token: CONFIG Value: DEFAULT
2018-11-29-10:54:39.601 [HFISRV:989] Config DEFAULT allocated.
2018-11-29-10:54:39.601 [HFISRV:969] Token: SSL_REQUIRED Value: YES
2018-11-29-10:54:39.601 [HFISRV:969] Token: WORKDIR Value: /etc/hfi/v11/hfisrv1
2018-11-29-10:54:39.602 [HFISRV:1070] Confirmed temporary write access ok dir=/etc/hfi/v11/hfisrv1.
2018-11-29-10:54:39.602 [HFISRV:969] Token: SPAWN_STEPLIB Value: HFI11SVC.BUILD.LOAD ...
2018-11-29-10:54:39.602 [HFISRV:969] Token: CONFIG Value: FM
2018-11-29-10:54:39.602 [HFISRV:989] Config FM allocated.
2018-11-29-10:54:39.602 [HFISRV:969] Token: SPAWN_PROGRAM Value: HFMCSEP
2018-11-29-10:54:39.602 [HFISRV:1089] Creating temp filename.
2018-11-29-10:54:39.602 [HFISRV:1106] Created temporary spawn image file ok.
2018-11-29-10:54:39.602 [HFISRV:1116] spawn_program /etc/hfi/v11/hfisrv1/HFMCSEP
2018-11-29-10:54:39.602 [HFISRV:1117] spawn_fn HFMCSEP
2018-11-29-10:54:39.602 [HFISRV:969] Token: SPAWN_JOBNAME Value: FMCLIENT
2018-11-29-10:54:39.602 [HFISRV:969] Token: SPAWN_STEPLIB Value: HFM.V1R1M2.OPTIONS...
2018-11-29-10:54:39.602 [HFISRV:969] Token: SPAWN_PARMS_SECTION Value:
2018-11-29-10:54:40.495 [HFISRV:1956] Environment open rc=0 Handle=16AB09A8 Ha=16AA6490
2018-11-29-10:54:40.495 [HFISRV:1965] Set SSLV2 off rc=0 
2018-11-29-10:54:40.495 [HFISRV:1973] Set SSLV3 off rc=0
2018-11-29-10:54:40.495 [HFISRV:1982] Set TLSV1 off rc=0
2018-11-29-10:54:40.495 [HFISRV:1997] Certfile=/etc/hfi/v11/hfisrv1/HFISRVC3-HFICERT.kdb
2018-11-29-10:54:40.495 [HFISRV:1998] Set keyring rc=0
2018-11-29-10:54:40.495 [HFISRV:2006] Set pw rc=0
2018-11-29-10:54:40.511 [HFISRV:2014] Environment init rc=0 Handle=16AB09A8
2018-11-29-10:54:40.511 [HFISRV:281] Mixed case password support is off
2018-11-29-10:54:40.512 [HFISRV:1902] Set socket linger rc=0 
2018-11-29-10:54:40.512 [HFISRV:1906] Set socket reuseaddr rc=0  
2018-11-29-10:54:40.512 [HFISRV:1910] Set socket keepalive rc=0  
2018-11-29-10:54:40.512 [HFISRV:301] Launching accept thread socket 0, listen code 0
2018-11-29-10:54:40.512 [HFISRV:513] Acceptor thread running.
2018-11-29-10:54:40.512 [HFISRV:527] About to accept.

If the highlighted statements are similar to the example that is shown here, all rc=0, then try to connect.