getnetconfig()--Return Current Record from the Netconfig File

Syntax

 #include <netconfig.h>

 struct netconfig *getnetconfig(void *);

  Service Program Name: QZNFTRPC

  Default Public Authority: *USE

  Threadsafe: No

The getnetconfig() function returns the pointer to the current record in the netconfig file and increments its pointer to the next record.

Parameters

void pointer (Input): A void pointer that is set by a call to the setnetconfig() function.

Authorities

No authorization is required.

Return Value

netconfig	getnetconfig() was successful. A pointer to the current netconfig structure in the netconfig file is returned.
NULL	getnetconfig() was not successful. A NULL pointer is returned. The errno global variable is set to indicate the error.

Error Conditions

If getnetconfig() is not successful, errno usually indicates one of the following errors. Under some conditions, errno could indicate an error other than those listed here.

[EUNKNOWN]

Unknown system state.

The operation failed because of an unknown system state. See any messages in the job log and correct any errors that are indicated. Then retry the operation.

Error Messages

Message ID	Error Message Text
CPE3418 E	Possible APAR condition or hardware failure.
CPF3CF2 E	Error(s) occurred during running of &1 API.
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.

Example

For more information, see the example for endnetconfig()--Release the Pointer in the Netconfig File.

API introduced: V4R2

[ Back to top | Remote Procedure Call (RPC) APIs | APIs by category ]