cwbUN_CheckAS400Name

Purpose

Returns an indication of whether a specified string is a valid name parameter on the iSeries™ server.

Syntax

CWBAPI unsigned int WINAPI cwbUN_CheckAS400Name(
    const char * szAS400Name,
      const char * szSystemName,
    USHORT usTypeId
    );

Parameters

const char * szAS400Name - input

The iSeries name whose validity is to be checked.

const char * szSystemName - input

The name of the iSeries system on which to perform the check.

USHORT usTypeId - input

A numeric value that indicates how the input string should be interpreted: as a long object name, a short object name, a communications name, or a string (type constants are defined above).

Return Codes

The following list shows common return values:

CWB_OK

Successful completion.

CWBUN_NAME_TOO_LONG

Name is too long.

CWBUN_NAME_NULLSTRING

String is empty - no characters at all.

CWBUN_NAME_INVALIDCHAR

Character not valid.

CWBUN_NAME_STRINGTOOLONG

String is too long.

CWBUN_NAME_MISSINGENDQUOTE

End quote is missing.

CWBUN_NAME_INVALIDQUOTECHAR

Character not valid for quote string.

CWBUN_NAME_ONLYBLANKS

Found a string of only blanks.

CWBUN_NAME_STRINGTOOSHORT

String is too short.

CWBUN_NAME_TOOLONGFORIBM

String is OK, but too long for IBM^® command.

CWBUN_NAME_INVALIDFIRSTCHAR

The first character is not valid.

Usage

None