End NetWare Connection (QfpzEndNtwCnn) API


  Required Parameter Group:

1 Input data Input Char(*)
2 Length of input data Input Binary(4)
3 Format name Input Char(8)
4 Error code I/O Char(*)

  Default Public Authority: *USE

  Library Name/Service Program: QFPNTWE/QFPZAAPI

  Threadsafe: No

The End NetWare Connection (QfpzEndNtwCnn) API ends a connection to a NetWare server. Connections to a server that was started from this iSeries server system, other iSeries servers, or workstations can be ended. Use the Work with NetWare Connections (WRKNTWCNN) command to view a list of connections.


Authorities and Locks

Special Authority
The connection must have been started by the current job, or the caller must have job control (*JOBCTL) special authority.
NetWare Authority
If this iSeries server did not start the connection being ended, the caller must have operator privileges for the server.

Note: To have operator privileges, the caller must have an authenticated connection to the server. The caller must be a NetWare user who is a member of the OPERATORS property for the server.


Required Parameter Group

Input data
INPUT; CHAR(*)

The input data that identifies the connections to be ended. The format name determines the format and content of this data. For detailed descriptions of the data's format and content, see Input Data Formats. For detailed descriptions of the fields in this structure, see Field Descriptions.

Length of input data
INPUT; BINARY(4)

The length of the input data structure.

Format name
INPUT; CHAR(8)

The format and content of the input data structure.

The following formats are supported:

ENDC0100 End connections for the current job on the specified servers.
ENDC0200 End the specified connection number on the specified server.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error Code Parameter.


Input Data Formats

ENDC0100 Format

Offset Type Field
Dec Hex
0 0 BINARY(4) Offset to server name
4 4 BINARY(4) Length of server name
8 8 BINARY(4) Reserved
    CHAR(*) Server name


ENDC0200 Format

Offset Type Field
Dec Hex
0 0 BINARY(4) Offset to server name
4 4 BINARY(4) Length of server name
8 8 BINARY(4) Connection number
12 C BINARY(4) Reserved
    CHAR(*) Server name


Field Descriptions

Connection number. The connection number by which the connection is known on the server.

Length of server name. The length, in bytes, of the server name.

Offset to server name. The offset, in bytes, from the start of the input data to the server name.

Reserved. Set this field to binary zeros.

Server name. The name of the server. If format ENDC0100 is specified, the following special value may be used:

*ALL End connections to all servers.

Error Messages

Message ID Error Message Text
CPF24B4 E Severe error while addressing parameter list.
CPF3C1D E Length specified in parameter &1 not valid.
CPF3C21 E Format name &1 is not valid.
CPF3C90 E Literal value cannot be changed.
CPF3CF1 E Error code parameter not valid.
CPF90FF E *JOBCTL special authority required to do requested operation.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.
FPE0211 E Parameter length &1 not valid for field &2.
FPE0212 E Field offset and length not within data.
FPE021B E Connection &1 on server &2 not found.
FPE0230 E Connection type -1 must be single value.
FPE0231 E Value &1 not valid for connection type.
FPE0232 E User &1 not connected to server.
FPE023F E Server operator privileges required.

API introduced: V3R7
Top | Security APIs | APIs by category