Add Wireless Ctl Member (ADDEWCM)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Add Extended Wireless Controller Member (ADDEWCM) command adds a source file member with extended wireless controller parameters to the specified source file. This data is downloaded to the wireless controller when the controller is varied on. Specific Portable Transaction Computer (PTC) and bar code configurations are added to this member using the Add Extended Wireless Controller PTC Entry (ADDEWCPTCE) and Add Extended Wireless Controller Bar Code Entry (ADDEWCBCDE) commands.

Restriction: If the values specified for the INZFILE and INZMBR parameters of this command do not match the values specified for the corresponding parameters of the wireless controller description, extended wireless controller configuration data will not be downloaded to the wireless adapter.

Restriction: To execute this command, the user profile requires *IOSYSCFG special authority.

Note: You can use the Change Controller Description (Local Work Station) (CHGCTLLWS) command to view or change values specified for the INZFILE and INZMBR parameters in the wireless controller description.

Top

Parameters

Keyword Description Choices Notes
INZMBR Initialization source member Name Required, Positional 1
INZFILE Initialization source file Qualified object name Optional, Positional 2
Qualifier 1: Initialization source file Name, QEWCSRC
Qualifier 2: Library Name, *LIBL, *CURLIB
TXPADR Destination ID 4001-4FFE, 4001 Optional
TXPPORT Transport port 0-15, 0 Optional
TEXT Text 'description' Character value, *BLANK Optional
KBDMAPMBR Keyboard remap source member Name, *NONE Optional
SCNFMTMBR Screen reformat rules member Name, *NONE Optional
KBDMAPFILE Keyboard remapping source file Qualified object name Optional
Qualifier 1: Keyboard remapping source file Name, QEWCKBDMAP
Qualifier 2: Library Name, QGPL
SCNFMTFILE Screen reformatting rules file Qualified object name Optional
Qualifier 1: Screen reformatting rules file Name, QEWCSCNFMT
Qualifier 2: Library Name, QGPL
Top

Initialization source member (INZMBR)

Specifies the name of the source file member containing the extended wireless controller configuration data that is added to the source file.

Top

Initialization source file (INZFILE)

Specifies the name of a source physical file to contain extended configuration source file member. If the source physical file does not exist, this command will fail.

The name of the source file can be qualified by one of the following library values:

*LIBL
All libraries in the job's library list are searched until the first match is found.
*CURLIB
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
library-name
Specify the name of the library to be searched.

The possible values are:

QEWCSRC
The source file name QEWCSRC is used.
source-file-name
Specify the name of an existing source physical file to which the member is added.
Top

Destination ID (TXPADR)

Specifies the local destination ID (transport address) that the PTC attempts to connect to at emulation startup time. This is a 4-byte hexadecimal number with valid values ranging from 4001 through 4FFE. The destination ID must match the destination ID used in the PTC(s).

The possible values are:

destination ID (transport-address)
Specify the local destination ID (transport address).
Top

Transport port (TXPPORT)

Specifies the local transport port connection number of the controller. The valid range is from 0 through 15. The value used by the PTC(s) is 0.

The possible values are:

0
The value 0 is used.
transport-port
Specify the local transport port connection number.
Top

Text 'description' (TEXT)

Specifies text that briefly describes the program and its function. More information on this parameter is in the CL Reference book, Appendix A.

The possible values are:

*BLANK
Text is not specified.
'description'
Specify no more than 50 characters of text, enclosed in apostrophes.
Top

Keyboard remap source member (KBDMAPMBR)

Specifies the source physical file member that contains the Keyboard Map information.

NOTE: The Keyboard Mapping function is not supported on the 2668 Feature Number.

The possible values are:

*NONE
Keyboard Mapping file member is not used.
source-file-member
The name of the file member that specifies the Keyboard Map information.
Top

Screen reformat rules member (SCNFMTMBR)

Specifies the source physical file member that contains the Screen Reformatter information

NOTE: The Screen Reformatter function is not supported on the 2668 Feature Number.

The possible values are:

*NONE
Screen Reformatter file member is not used.
source-file-member
The name of the file member that specifies the Screen Reformatter information
Top

Keyboard remapping source file (KBDMAPFILE)

Specifies the name of a source physical file to contain Keyboard Map source file member. If the source physical file does not exist, this command will fail.

The name of the source file can be qualified by one of the following library values:

*LIBL
All libraries in the job's library list are searched until the first match is found.
*CURLIB
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
library-name
Specify the name of the library to be searched.

The possible values are:

QEWCKBDMAP
The source file name QEWCKBDMAP is used.
source-file-name
Specify the name of an existing source physical file to which the member is added.
Top

Screen reformatting rules file (SCNFMTFILE)

Specifies the name of a source physical file to contain Screen Reformatter source file member. If the source physical file does not exist, this command will fail.

The name of the source file can be qualified by one of the following library values:

*LIBL
All libraries in the job's library list are searched until the first match is found.
*CURLIB
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
library-name
Specify the name of the library to be searched.

The possible values are:

QEWCSCNFMT
The source file name QEWCSCNFMT is used.
source-file-name
Specify the name of an existing source physical file to which the member is added.
Top

Examples

ADDEWCM   INZMBR(EWC01)  INZFILE(*LIBL/QEWCSRC)

This command adds a member named EWC01 in the default source physical file QEWCSRC in the library list with the default TXPADR of 4001 and default TXPPORT of 0.

Top

Error messages

None

Top