Debugging of User-Defined Communications Applications

This section is intended to help you debug your user-defined communications applications. It contains information about:


System services and tools

The system provides several tools for debugging your user-defined communication applications. Some of the system-provided tools that are useful for developing user-defined communications applications include the following CL commands:


Program debug

Program debug (STRDBG) allows you to trace the program and variables, set stops, change variables, and display variables. You can use this function to verify that the parameters are passed correctly.


Work with communications status

The Work with Job command, Work with Communications Status option, (WRKJOB OPTION(*CMNSTS)) shows the enabled links and operation counts for each link. It also reports information such as the communications handle the last operation requested, and the total input, output, and other operations requested. This information is shown for every link enabled by the job.


Display job log

The Work with Job command, selecting the Display job log option (WRKJOB OPTION(*JOBLOG)) allows you to view the messages in the job log that help determine the exact cause of the problem.


Display connection status

The Display Connection Status (DSPCNNSTS) command shows information about the switched virtual circuits (SVCs) and permanent virtual circuits (PVCs) that are in use by the application using the device description.

Note: The Display Line Description (DSPLIND) command also shows for each line, the SVCs that are in use, available, or attached to a controller description. This is not true for PVCs.


Display inbound routing information

Pressing F6 (Display inbound routing information) when the Display Connection Status display is shown (DSPCNNSTS command) shows the results of the calls to the Set Filter (QOLSETF) API. It also helps to determine which device description has set a filter with duplicate inbound routing information.


Work with communications trace

Using the communications trace function you can obtain information about a communications line. You can access the communications trace function through the following CL commands:

For more information about using the communications trace CL commands, see the Communications ManagementLink to PDF manual.

You can also access the communications trace function through the system service tools. You can use this function by entering the Start System Service Tools (STRSST) command and selecting the option to start a service tool.

Using the option to Work with communications trace shows data just as it appears to the network. If the application requests that data be sent and the request does not appear in the communications trace, the request is rejected. The return and reason codes, and the error code reported in the parameter list for the Send Data (QOLSEND) API indicates the reason the request was rejected.


Work with error log

The error log utility is part of the system service tools. You can use it by entering the Start System Service Tools (STRSST) command and selecting the option to start a service tool.

Some communications errors are reported by the system to the error log. A remote application that is communicating with a user-defined communications application on the local system, could cause an entry to be generated in the error log if one of the following conditions are met:

For both cases, the associated message in QSYSOPR identifies the error log that contains the error log entry. The error log entry contains information only.


Dump system object to view user spaces

The Dump System Object (DMPSYSOBJ) command is used to inspect the user spaces after they are filled in by your application. The following examples indicate what the user spaces look like for some of the operations.

User Space to Set a Filter to Route Inbound Data

This user space is filled in to activate two X.25 filters which will route any X.25 call containing X'BB', or X'DD' in the first byte of call user data (protocol ID byte).


Figure 1-1. User Space to Set a Filter to Route Incoming X.25 Calls

5738SS1 V2R1M0  910524       AS/400 DUMP       006625/QSECOFR/QPADEV0001  12/21/90 12:42:07  PAGE   1
DMPSYSOBJ PARAMETERS
OBJ- OUTBUFFER                       CONTEXT-USRDFNCMN
OBJTYPE- *USRSPC
OBJECT TYPE-           SPACE                                           *USRSPC
NAME-        OUTBUFFER                       TYPE-          19   SUBTYPE-          34
LIBRARY-     USRDFNCMN                       TYPE-          04   SUBTYPE-          01
CREATION-    12/21/90  12:40:03              SIZE-          00002200
OWNER-       QSECOFR                         TYPE-          08   SUBTYPE-          01
ATTRIBUTES-          0800                    ADDRESS-       00A00A00   0000
SPACE ATTRIBUTES-
  000000   00000080 00000060 1934D6E4 E3C2E4C6   C6C5D940 40404040 40404040 40404040  *  -  OUTBUFFER    *
  000020   40404040 40404040 E0000000 00000000   00002000 00800000 00000000 00000000  *   \              *
  000040   00000000 00000000 0005004D 42000400   00000000 00000000 00000000 00000000  *      (a          *
SPACE-
  000000   01000002 001001BB 00000000 00000000   00000000 000001DD 00000000 00000000  *    Y       t     *
  000020   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                  *
        LINES  000040    TO    001FFF  SAME AS ABOVE
POINTERS-
  NONE
OIR DATA-
TEXT-
  000000   D8D7C1C4 C5E5F0F0 F0F1D8E2 C5C3D6C6   D9404040 F0F0F6F6 F2F5    *QPADEV0001QSECOFR   006625   *
SERVICE-
  000000   40404040 40404040 40404040 40404040   40404040 40F14040 40404040 40404040  *          1       *
  000020   40404040 40404040 404040E5 F2D9F1D4   F0F0F9F0 F1F2F2F1 F1F2F4F0 F0F44040  *V2R1M00901221124004 *
  000040   40404040 40404040 40404040 40404040   40404040 40404040 40404040 40404040  *                  *
  000060   40404040 40404040 40404040 40404040   40404040 40404040 00000000 00000000  *                  *
  000080   00000000 00000000 00000000 00000000   00000000 00000000 40400000 00000000  *                  *
  0000A0   00000000 00000000                                                          *                  *
END OF DUMP
        * * * * *  E N D  O F  L I S T I N G  * * * * *

User Space for X'B000' Operation, Initiating an SVC Call

The user space below has been filled in to initiate an SVC call specifying the following:


Figure 1-2. User Space to Send an SVC Call

5738SS1 V2R1M0  910524     AS/400 DUMP     006625/QSECOFR/QPADEV0001    12/21/90 12:47:42      PAGE   1
DMPSYSOBJ PARAMETERS
OBJ- OUTPUTBUF                       CONTEXT-USRDFNCMN
OBJTYPE- *USRSPC
OBJECT TYPE-           SPACE                                           *USRSPC
NAME-        OUTPUTBUF                       TYPE-          19   SUBTYPE-          34
LIBRARY-     USRDFNCMN                       TYPE-          04   SUBTYPE-          01
CREATION-    12/21/90  12:36:28              SIZE-          00001200
OWNER-       QSECOFR                         TYPE-          08   SUBTYPE-          01
ATTRIBUTES-          0800                    ADDRESS-       00A00100   0000
SPACE ATTRIBUTES-
  000000   00000080 00000060 1934D6E4 E3D7E4E3   C2E4C640 40404040 40404040 40404040  *  -  OUTPUTBUF   *
  000020   40404040 40404040 E0000000 00000000   00001000 00800000 00000000 00000000  *     \           *
  000040   00000000 00000000 0005004D 42000400   00000000 00000000 00000000 00000000  *        (a       *
SPACE-
  000000   02000000 FFFFFFFF FFFFFFFF 00000000   00000008 40100001 00000000 00000000  *                 *
  000020   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                 *
        LINES  000040    TO    0000BF  SAME AS ABOVE
  0000C0   00000000 00000000 00000000 00000000   00000000 00000001 BB000000 00000000  *            Y    *
  0000E0   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                 *
        LINES  000100    TO    0001BF  SAME AS ABOVE
  0001C0   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00004000  *                 *
  0001E0   00200000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                 *
  000200   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                 *
        LINES  000220    TO    000FFF  SAME AS ABOVE
POINTERS-
  NONE
OIR DATA-
TEXT-
  000000   D8D7C1C4 C5E5F0F0 F0F2D8E2 C5C3D6C6   D9404040 F0F0F6F6 F2F7   *QPADEV0002QSECOFR   006627   *
SERVICE-
  000000   40404040 40404040 40404040 40404040   40404040 40F14040 40404040 40404040  *         1       *
  000020   40404040 40404040 404040E5 F2D9F1D4   F0F0F9F0 F1F2F2F1 F1F2F3F6 F2F84040  *V2R1M00901221123628 *
  000040   40404040 40404040 40404040 40404040   40404040 40404040 40404040 40404040  *                 *
  000060   40404040 40404040 40404040 40404040   40404040 40404040 00000000 00000000  *                 *
  000080   00000000 00000000 00000000 00000000   00000000 00000000 40400000 00000000  *                 *
  0000A0   00000000 00000000                                                          *                 *
END OF DUMP
                                          * * * * *  E N D  O F  L I S T I N G  * * * * *

User Space Containing an Incoming X.25 Call, Operation X'B201'

This user space shows the following:

The application received this call because it had set a filter to indicate to the system that it should route incoming X.25 calls that have the first byte of call user data (the protocol identifier) equal to X'BB' to the application.


Figure 1-3. User Space Containing an Incoming X.25 Call

5763SS1 V3R1M0  940909   AS/400 DUMP      023099/QSYSOPR/QPADEV0014   03/07/94 11:57:24     PAGE   1
DMPSYSOBJ PARAMETERS
OBJ- INBUFFER                        CONTEXT- USRDFNCMN
TYPE- *ALL SUBTYPE-*ALL
OBJECT TYPE-           SPACE                                           *USRSPC
NAME-        INBUFFER                        TYPE-          19   SUBTYPE-          34
LIBRARY-     USRDFNCMN                       TYPE-          04   SUBTYPE-          01
CREATION-    03/07/94  11:53:15              SIZE-          0000002200
OWNER-       QSYSOPR                         TYPE-          08   SUBTYPE-          01
ATTRIBUTES-          0800                    ADDRESS-       000001DE7A00   0000
SPACE ATTRIBUTES-
  000000   00FFFF00 00000060 1934C9D5 C2E4C6C6   C5D94040 40404040 40404040 40404040  * -  INBUFFER       *
  000020   40404040 40404040 E0000000 00000000   00002000 00810000 00000000 00000000  *     \       a     *
  000040   00000000 00000000 00D601DE 73000400   00000000 00000000 00000000 00000000  *   O £   *
SPACE-
  000000   00000005 00800007 00800007 00000000   00000008 40100000 00000000 00000000  *                   *
  000020   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                   *
        LINES  000040    TO    0000BF  SAME AS ABOVE
  0000C0   00000000 00000000 00000000 00000000   00000000 00000001 BB000000 00000000  *                   *
  0000E0   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                   *
        LINES  000100    TO    00013F  SAME AS ABOVE
  000140   00000000 00000000 00000000 00000000   00000000 00000000 08402000 00000000  *                   *
  000160   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                   *
        LINES  000180    TO    001FFF  SAME AS ABOVE
POINTERS-
  NONE
OIR DATA-
TEXT-
  000000   D8D7C1C4 C5E5F0F0 F1F4D8E2 E8E2D6D7   D9404040 F0F2F3F0 F9F9   *QPADEV0014QSYSOPR   023099     *
SERVICE-
  000000   40404040 40404040 40404040 40404040   40404040 40F14040 40404040 40404040  *          1        *
  000020   40404040 40404040 404040E5 F3D9F1D4   F0F0F9F4 F0F3F0F7 F1F1F5F3 F1F54040  *V3R1M00940307115315 *
  000040   40404040 40404040 40404040 40404040   40404040 40404040 40404040 40404040  *                   *
  000060   40404040 40404040 40404040 40404040   40404040 40404040 00000000 00000000  *                   *
  000080   00000000 00000000 00000000 00000000   00000000 00000000 40400000 00000000  *                   *
  0000A0   00000000 00000000                                                          *                   *
USAGE-
  000000   D8E2E8E2 D6D7D940 4040D9C3 C8C1E2F3   F2F0                          *QSYSOPR   RCHAS320        *
END OF DUMP
                                          * * * * *  E N D  O F  L I S T I N G  * * * * *

User Space to Accept an Incoming X.25 Call, Operation X'B400'

This user space was filled in to accept the incoming call, request default packet and window sizes, and no other additional facilities. The a maximum amount of contiguous data is set at 16KB and the automatic flow control is set at 32.


Figure 1-4. User Space to Accept an Incoming X.25 Call

5738SS1 V2R1M0  910524   AS/400 DUMP     006625/QSECOFR/QPADEV0001     12/21/90 12:48:06      PAGE   1
DMPSYSOBJ PARAMETERS
OBJ- OUTBUFFER                       CONTEXT-USRDFNCMN
OBJTYPE- *USRSPC
OBJECT TYPE-           SPACE                                           *USRSPC
NAME-        OUTBUFFER                       TYPE-          19   SUBTYPE-          34
LIBRARY-     USRDFNCMN                       TYPE-          04   SUBTYPE-          01
CREATION-    12/21/90  12:40:03              SIZE-          00002200
OWNER-       QSECOFR                         TYPE-          08   SUBTYPE-          01
ATTRIBUTES-          0800                    ADDRESS-       00A00A00   0000
SPACE ATTRIBUTES-
  000000   00000080 00000060 1934D6E4 E3C2E4C6   C6C5D940 40404040 40404040 40404040  * -  OUTBUFFER    *
  000020   40404040 40404040 E0000000 00000000   00002000 00800000 00000000 00000000  *        \        *
  000040   00000000 00000000 0005004D 42000400   00000000 00000000 00000000 00000000  *           (a    *
SPACE-
  000000   00000000 FFFFFFFF FFFFFFFF 00000000   00000000 00000000 00000000 00000000  *                 *
  000020   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                 *
        LINES  000040    TO    0001BF  SAME AS ABOVE
  0001C0   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00004000  *                 *
  0001E0   00200000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                 *
  000200   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                 *
        LINES  000220    TO    001FFF  SAME AS ABOVE
POINTERS-
  NONE
OIR DATA-
TEXT-
  000000   D8D7C1C4 C5E5F0F0 F0F1D8E2 C5C3D6C6   D9404040 F0F0F6F6 F2F   *QPADEV0001QSECOFR   006625     *
SERVICE-
  000000   40404040 40404040 40404040 40404040   40404040 40F14040 40404040 40404040  *          1       *
  000020   40404040 40404040 404040E5 F2D9F1D4   F0F0F9F0 F1F2F2F1 F1F2F4F0 F0F44040  *V2R1M00901221124004 *
  000040   40404040 40404040 40404040 40404040   40404040 40404040 40404040 40404040  *                  *
  000060   40404040 40404040 40404040 40404040   40404040 40404040 00000000 00000000  *                  *
  000080   00000000 00000000 00000000 00000000   00000000 00000000 40400000 00000000  *                  *
  0000A0   00000000 00000000                                                          *                  *
END OF DUMP
                                          * * * * *  E N D  O F  L I S T I N G  * * * * *

User Spaces for Sending Data, Operation X'0000'

Two user spaces are shown below. The first is the output buffer and the second is the output buffer descriptor.

The user spaces below are filled in to send three data units of 512 bytes each. The first two data units have the more data indicator turned on, indicating that all the data units are contiguous.

Note: This link was enabled, specifying a data unit size of 512 bytes.


Figure 1-5. User Space (Buffer) to Send Three Data Units

5738SS1 V2R1M0  910524   AS/400 DUMP      006625/QSECOFR/QPADEV0001    12/21/90 12:55:19     PAGE   1
DMPSYSOBJ PARAMETERS
OBJ- OUTPUTBUF                       CONTEXT-USRDFNCMN
OBJTYPE- *USRSPC
OBJECT TYPE-           SPACE                                           *USRSPC
NAME-        OUTPUTBUF                       TYPE-          19   SUBTYPE-          34
LIBRARY-     USRDFNCMN                       TYPE-          04   SUBTYPE-          01
CREATION-    12/21/90  12:36:28              SIZE-          00001200
OWNER-       QSECOFR                         TYPE-          08   SUBTYPE-          01
ATTRIBUTES-          0800                    ADDRESS-       00A00100   0000
SPACE ATTRIBUTES-
  000000   00000080 00000060 1934D6E4 E3D7E4E3   C2E4C640 40404040 40404040 40404040  * -  OUTPUTBUF    *
  000020   40404040 40404040 E0000000 00000000   00001000 00800000 00000000 00000000  *        \        *
  000040   00000000 00000000 0005004D 42000400   00000000 00000000 00000000 00000000  *           (a    *
SPACE-
  000000   F0F10000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *01               *
  000020   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                 *
        LINES  000040    TO    0001FF  SAME AS ABOVE
  000200   F0F20000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *02               *
  000220   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                 *
        LINES  000240    TO    0003FF  SAME AS ABOVE
  000400   F0F30000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *03               *
  000420   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                 *
        LINES  000440    TO    000FFF  SAME AS ABOVE
POINTERS-
  NONE
OIR DATA-
TEXT-
  000000   D8D7C1C4 C5E5F0F0 F0F2D8E2 C5C3D6C6   D9404040 F0F0F6F6 F2F7   *QPADEV0002QSECOFR   006627    *
SERVICE-
  000000   40404040 40404040 40404040 40404040   40404040 40F14040 40404040 40404040  *           1      *
  000020   40404040 40404040 404040E5 F2D9F1D4   F0F0F9F0 F1F2F2F1 F1F2F3F6 F2F84040  *V2R1M00901221123628 *
  000040   40404040 40404040 40404040 40404040   40404040 40404040 40404040 40404040  *                  *
  000060   40404040 40404040 40404040 40404040   40404040 40404040 00000000 00000000  *                  *
  000080   00000000 00000000 00000000 00000000   00000000 00000000 40400000 00000000  *                  *
  0000A0   00000000 00000000                                                          *                  *
END OF DUMP
                                          * * * * *  E N D  O F  L I S T I N G  * * * * *

Figure 1-6. User Space (Descriptor Element) to Describe the Three Data Units

5738SS1 V2R1M0  910524    AS/400 DUMP     006625/QSECOFR/QPADEV0001     12/21/90 12:55:58     PAGE   1
DMPSYSOBJ PARAMETERS
OBJ- OUTPUTBUFD                      CONTEXT-USRDFNCMN
OBJTYPE- *USRSPC
OBJECT TYPE-           SPACE                                           *USRSPC
NAME-        OUTPUTBUFD                      TYPE-          19   SUBTYPE-          34
LIBRARY-     USRDFNCMN                       TYPE-          04   SUBTYPE-          01
CREATION-    12/21/90  12:36:27              SIZE-          00000400
OWNER-       QSECOFR                         TYPE-          08   SUBTYPE-          01
ATTRIBUTES-          0800                    ADDRESS-       009FFE00   0000
SPACE ATTRIBUTES-
  000000   00000080 00000060 1934D6E4 E3D7E4E3   C2E4C6C4 40404040 40404040 40404040  *-  OUTPUTBUFD    *
  000020   40404040 40404040 E0000000 00000000   00000200 00800000 00000000 00000000  *        \        *
  000040   00000000 00000000 0005004D 42000400   00000000 00000000 00000000 00000000  *           (a    *
SPACE-
  000000   02000100 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                 *
  000020   02000100 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                 *
  000040   02000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                 *
  000060   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                 *
        LINES  000080    TO    0001FF  SAME AS ABOVE
POINTERS-
  NONE
OIR DATA-
TEXT-
  000000   D8D7C1C4 C5E5F0F0 F0F2D8E2 C5C3D6C6   D9404040 F0F0F6F6 F2F7   *QPADEV0002QSECOFR   006627   *
SERVICE-
  000000   40404040 40404040 40404040 40404040   40404040 40F14040 40404040 40404040  *         1       *
  000020   40404040 40404040 404040E5 F2D9F1D4   F0F0F9F0 F1F2F2F1 F1F2F3F6 F2F74040  * V2R1M00901221123627 *
  000040   40404040 40404040 40404040 40404040   40404040 40404040 40404040 40404040  *                 *
  000060   40404040 40404040 40404040 40404040   40404040 40404040 00000000 00000000  *                 *
  000080   00000000 00000000 00000000 00000000   00000000 00000000 40400000 00000000  *                 *
  0000A0   00000000 00000000                                                          *                 *
END OF DUMP
                                          * * * * *  E N D  O F  L I S T I N G  * * * * *

User Spaces for Receiving Data, Operation X'0001'

Two user spaces are shown below. The first is the input buffer and the second is the input buffer descriptor.

The user spaces below are filled in showing that 2 data units were received. The first data unit has the more data indicator turned on in the buffer descriptor for the data unit. This means that the X.25 more indicator was turned on in all the X.25 packets that this data unit contains. The second data unit does not have the more data indicator turned on, indicating that the last X.25 packet in the data unit had the X.25 more indicator turned off. The first and second data unit are considered to be logically contiguous to the application program.

Note: This link was enabled specifying a data unit size of 1024 bytes. The sending system sent the data in data unit sizes of 512 bytes and they were combined into the 1024 byte data unit size by the local system. The data unit size is not negotiated end-to-end, neither is the maximum amount of contiguous data or the automatic flow control. Because the values are important, each application should be aware of what the other application has specified for each value. See Sending and Receiving Data Packets for more information.


Figure 1-7. User Space (Buffer) Containing the Three Data Units

5738SS1 V2R1M0  910524    AS/400 DUMP     006625/QSECOFR/QPADEV0001   12/21/90 12:59:33    PAGE   1
DMPSYSOBJ PARAMETERS
OBJ- INBUFFER                        CONTEXT-USRDFNCMN
OBJTYPE- *USRSPC
OBJECT TYPE-           SPACE                                           *USRSPC
NAME-        INBUFFER                        TYPE-          19   SUBTYPE-          34
LIBRARY-     USRDFNCMN                       TYPE-          04   SUBTYPE-          01
CREATION-    12/21/90  12:40:03              SIZE-          00002200
OWNER-       QSECOFR                         TYPE-          08   SUBTYPE-          01
ATTRIBUTES-          0800                    ADDRESS-       00A00400   0000
SPACE ATTRIBUTES-
  000000   00000080 00000060 1934C9D5 C2E4C6C6   C5D94040 40404040 40404040 40404040  * -  INBUFFER       *
  000020   40404040 40404040 E0000000 00000000   00002000 00800000 00000000 00000000  *     \             *
  000040   00000000 00000000 0005004D 42000400   00000000 00000000 00000000 00000000  *           (a      *
SPACE-
  000000   F0F10000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *01                 *
  000020   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                   *
        LINES  000040    TO    0001FF  SAME AS ABOVE
  000200   F0F20000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *02                 *
  000220   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                   *
        LINES  000240    TO    0003FF  SAME AS ABOVE
  000400   F0F30000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *03                 *
  000420   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                   *
        LINES  000440    TO    001FFF  SAME AS ABOVE
POINTERS-
  NONE
OIR DATA-
TEXT-
  000000   D8D7C1C4 C5E5F0F0 F0F1D8E2 C5C3D6C6   D9404040 F0F0F6F6 F2F5   *QPADEV0001QSECOFR   006625     *
SERVICE-
  000000   40404040 40404040 40404040 40404040   40404040 40F14040 40404040 40404040  *           1       *
  000020   40404040 40404040 404040E5 F2D9F1D4   F0F0F9F0 F1F2F2F1 F1F2F4F0 F0F34040  * V2R1M00901221124003 *
  000040   40404040 40404040 40404040 40404040   40404040 40404040 40404040 40404040  *                   *
  000060   40404040 40404040 40404040 40404040   40404040 40404040 00000000 00000000  *                   *
  000080   00000000 00000000 00000000 00000000   00000000 00000000 40400000 00000000  *                   *
  0000A0   00000000 00000000                                                          *                   *
END OF DUMP
                                          * * * * *  E N D  O F  L I S T I N G  * * * * *

Figure 1-8. User Space (Descriptor Element) Describing the Three Data Units

5738SS1 V2R1M0  910524    AS/400 DUMP    006625/QSECOFR/QPADEV0001   12/21/90 12:59:41     PAGE   1
DMPSYSOBJ PARAMETERS
OBJ- INBUFFERD                       CONTEXT-USRDFNCMN
OBJTYPE- *USRSPC
OBJECT TYPE-           SPACE                                           *USRSPC
NAME-        INBUFFERD                       TYPE-          19   SUBTYPE-          34
LIBRARY-     USRDFNCMN                       TYPE-          04   SUBTYPE-          01
CREATION-    12/21/90  12:40:03              SIZE-          00000400
OWNER-       QSECOFR                         TYPE-          08   SUBTYPE-          01
ATTRIBUTES-          0800                    ADDRESS-       00A00200   0000
SPACE ATTRIBUTES-
  000000   00000080 00000060 1934C9D5 C2E4C6C6   C5D9C440 40404040 40404040 40404040  *  -  INBUFFERD    *
  000020   40404040 40404040 E0000000 00000000   00000200 00800000 00000000 00000000  *        \         *
  000040   00000000 00000000 0005004D 42000400   00000000 00000000 00000000 00000000  *           (a     *
SPACE-
  000000   04000100 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                  *
  000020   02000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                  *
  000040   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                  *
        LINES  000060    TO    0001FF  SAME AS ABOVE
POINTERS-
  NONE
OIR DATA-
TEXT-
  000000   D8D7C1C4 C5E5F0F0 F0F1D8E2 C5C3D6C6   D9404040 F0F0F6F6 F2F5   *QPADEV0001QSECOFR   006625    *
SERVICE-
  000000   40404040 40404040 40404040 40404040   40404040 40F14040 40404040 40404040  *            1     *
  000020   40404040 40404040 404040E5 F2D9F1D4   F0F0F9F0 F1F2F2F1 F1F2F4F0 F0F34040  * V2R1M00901221124003 *
  000040   40404040 40404040 40404040 40404040   40404040 40404040 40404040 40404040  *                  *
  000060   40404040 40404040 40404040 40404040   40404040 40404040 00000000 00000000  *                  *
  000080   00000000 00000000 00000000 00000000   00000000 00000000 40400000 00000000  *                  *
  0000A0   00000000 00000000                                                          *                  *
END OF DUMP
                                          * * * * *  E N D  O F  L I S T I N G  * * * * *

User Space to Clear a Connection or Call, Operation X'B100'

This user space was filled in to end an SVC connection or clear an incoming call. No facilities or clear user data are requested with this, but cause and diagnostic codes are specified (these are not ISO or SNA codes).


Figure 1-9. User Space to Send an SVC Clear

5738SS1 V2R1M0  910524      AS/400 DUMP    006625/QSECOFR/QPADEV0001    12/21/90 13:14:48     PAGE   1
DMPSYSOBJ PARAMETERS
OBJ- OUTBUFFER                       CONTEXT-USRDFNCMN
OBJTYPE- *USRSPC
OBJECT TYPE-           SPACE                                           *USRSPC
NAME-        OUTBUFFER                       TYPE-          19   SUBTYPE-          34
LIBRARY-     USRDFNCMN                       TYPE-          04   SUBTYPE-          01
CREATION-    12/21/90  12:40:03              SIZE-          00002200
OWNER-       QSECOFR                         TYPE-          08   SUBTYPE-          01
ATTRIBUTES-          0800                    ADDRESS-       00A00A00   0000
SPACE ATTRIBUTES-
  000000   00000080 00000060 1934D6E4 E3C2E4C6   C6C5D940 40404040 40404040 40404040  *  -  OUTBUFFER  *
  000020   40404040 40404040 E0000000 00000000   00002000 00800000 00000000 00000000  *        \       *
  000040   00000000 00000000 0005004D 42000400   00000000 00000000 00000000 00000000  *           (a   *
SPACE-
  000000   0000BEBE 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *  XX            *
  000020   00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000  *                *
        LINES  000040    TO    001FFF  SAME AS ABOVE
POINTERS-
  NONE
OIR DATA-
TEXT-
  000000   D8D7C1C4 C5E5F0F0 F0F1D8E2 C5C3D6C6  D9404040 F0F0F6F6 F2F5   *QPADEV0001QSECOFR   006625  *
SERVICE-
  000000   40404040 40404040 40404040 40404040   40404040 40F14040 40404040 40404040  *        1       *
  000020   40404040 40404040 404040E5 F2D9F1D4   F0F0F9F0 F1F2F2F1 F1F2F4F0 F0F44040  * V2R1M00901221124004 *
  000040   40404040 40404040 40404040 40404040   40404040 40404040 40404040 40404040  *                *
  000060   40404040 40404040 40404040 40404040   40404040 40404040 00000000 00000000  *                *
  000080   00000000 00000000 00000000 00000000   00000000 00000000 40400000 00000000  *                *
  0000A0   00000000 00000000                                                          *                *
END OF DUMP
                                          * * * * *  E N D  O F  L I S T I N G  * * * * *

Error Codes

The system and user-defined communications support reports important information that is useful for determining recovery actions when an error occurs. This information is referred to as error codes that are reported either to the job log or to the QSYSOPR message queue. For a complete list of the messages that are signaled by the user-defined communications APIs, see Messages.

In some cases error codes are reported to your application in the error specific parameter. The following sections list the valid error codes. Some of the error codes represent actual coding errors, others only report additional information. For information about the error codes for the individual user-defined communications APIs, see User-Defined Communications Support APIs.


Local area network (lan) error codes

Figure 1-10 shows the valid hexadecimal codes your application can receive as a result of a call to the QOLSEND API using operation code X'0000'. The codes indicate that the data was never sent on the line. Associated with these error codes is a message in QSYSOPR, indicating the device description that caused the error, and the error code. After receiving the error code, the link will still be enabled and usable.

These error codes indicate to your application that a coding error was made and should be corrected.


Figure 1-10. Error Codes Received While Sending Data over LAN



X.25 error codes

Figure 1-11 shows the valid error codes your application can receive as a result of

These error codes indicate to your application that a coding error was made, or a failure condition occurred.


Figure 1-11. Error Codes Reported on X'B001', X'B301', and X'B400' Operations

Figure 1-12 shows the valid error codes your application can receive as a result of a call to the QOLRECV API with an operation code returned as X'B101'.

These error codes indicate to your application that the connection was cleared or reset for the following reasons.


Figure 1-12. Error Codes Reported on the X'B101' Operation

Figure 1-13 shows the valid error codes your application can receive as a result of a call to the QOLRECV API, returning the operation code, X'BF01'.

These error codes indicate to your application that the connection was cleared or reset for the following reasons.


Figure 1-13. Error Codes Reported on the X'BF01' Operation

Figure 1-14 shows the valid error codes your application can receive as a result of a call to the QOLSEND API with an operation code returned as X'0000'.

These error codes indicate to your application that the connection was cleared or reset for the following reasons.


Figure 1-14. Error Codes Resulting from a X'0000' Operation



Common Errors and Messages

This section shows some of the common errors that you or your application programmer may encounter. Some of these errors are detected by the APIs and reported to the application by the unsuccessful return and reason codes returned on each API. Other errors are program design errors, that your application programmer must detect and correct. The errors are listed by category:

Parameter Errors

User Space Errors

Queue Errors

Receive Data (QOLRECV) API Errors

Send Data (QOLSEND) API Errors

Enable Link (QOLELINK) API Errors

Query Line Description (QOLQLIND) API Errors


[ Back to top | Communications APIs | APIs by category ]