Change Wireless Ctl Member (CHGEWCM)

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

The Change Extended Wireless Controller Member (CHGEWCM) command changes the extended wireless controller parameters in the specified source file member. Specific Portable Transaction Computer (PTC) and bar code configurations in this member are changed using the Change Extended Wireless Controller PTC Entry (CHGEWCPTCE) and Change Extended Wireless Controller Bar Code Entry (CHGEWCBCDE) 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, Key, Positional 1
INZFILE Initialization source file Qualified object name Optional, Key, Positional 2
Qualifier 1: Initialization source file Name, QEWCSRC
Qualifier 2: Library Name, *LIBL, *CURLIB
TXPADR Destination ID 4001-4FFE, *SAME Optional
TXPPORT Transport port 0-15, *SAME Optional
TEXT Text 'description' Character value, *SAME Optional
KBDMAPMBR Keyboard remap source member Name, *SAME, *NONE Optional
SCNFMTMBR Screen reformat rules member Name, *SAME, *NONE Optional
KBDMAPFILE Keyboard remapping source file Qualified object name Optional
Qualifier 1: Keyboard remapping source file Name, *SAME, QEWCKBDMAP
Qualifier 2: Library Name, *SAME, QGPL
SCNFMTFILE Screen reformatting rules file Qualified object name Optional
Qualifier 1: Screen reformatting rules file Name, *SAME, QEWCSCNFMT
Qualifier 2: Library Name, *SAME, QGPL
Top

Initialization source member (INZMBR)

Specifies the name of the source file member to be changed. This member contains wireless controller configuration data.

Top

Initialization source file (INZFILE)

Specifies the name of the source physical file of the source file member to be changed. 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 the source physical file of the source member to change.
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:

*SAME
The value stays the same.
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:

*SAME
The value stays the same.
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:

*SAME
The text stays the same.
*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:

*SAME
The file member stays the same.
*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:

*SAME
The file member stays the same.
*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

CHGEWCM   INZMBR(EWC01)  INZFILE(MYLIB/QEWCSRC)  TXPPORT(2)

This command changes the extended wireless controller member EWC01 in the source physical file QEWCSRC in library MYLIB. The transport port connection number is changed to 2.

Top

Error messages

None

Top