Change EWC PTC Entry (CHGEWCPTCE)

The Change Extended Wireless Controller PTC Entry (CHGEWCPTCE) command changes the configurable Portable Transaction Computer (PTC) 5250 emulation operating parameters of the specified PTC group in the specified source file member.

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.

Notes:

  1. 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.
  2. A *DEV value specified by a parameter indicates a device specific default value. Since such values cannot be sent from the device, the current value for these parameters cannot be displayed.

Parameters

Keyword Description Choices Notes
PTCGRP PTC group Name Required, Key, Positional 1
INZMBR Initialization source member Name Required, Key, Positional 2
INZFILE Initialization source file Qualified object name Optional, Key, Positional 3
Qualifier 1: Initialization source file Name, QEWCSRC
Qualifier 2: Library Name, *LIBL
PTCRANGE PTC ID range Element list Optional
Element 1: Begin ID 0001-1022, *SAME
Element 2: End ID 0001-1022, *SAME
INTENSITY Intensity *SAME, *NORMAL, *INVERSE Optional
STSLINE Status line *SAME, *YES, *NO Optional
CSRTYPE Cursor type *SAME, *UNDERLINE, *BLOCK Optional
INACTTMR Inactivity timer 0-9999, *SAME, *DEV Optional
BCKLTTMR Backlight timer 0-9999, *SAME, *DEV Optional
BCKLTKEY Backlight key *SAME, *ON, *OFF Optional
BYPASSEXIT Bypass exit *SAME, *YES, *NO Optional
AUTORUN Automatic run *SAME, *YES, *NO Optional
PRINTER Printer *SAME, *SYSTEM, *PTC Optional
WANDTYPE Wand type *SAME, *NONE, *PENCIL, *LASER, *RS232 Optional
PECKRATE Wand pecking rate *SAME, *DEV, 2, 4, 8, 16, 32, 48 Optional
LASERTMR Laser read timer *SAME, *DEV, 1440, 2880, 4320, 5760 Optional
BCDFKEY Barcode function keys *SAME, *OFF, *ON Optional
AUTOENTER Auto Enter *SAME, *OFF, *ON Optional
CSRLOC Cursor location *SAME, *HOLD, *FIRST Optional
SHORTSCAN Short scan *SAME, *YES, *NO Optional
SCANEOF Scan end of file *SAME, *YES, *NO Optional
POLL Fast poll interval 0-9999, *SAME, *DEV Optional
POLLDLY Fast poll delay 0-9999, *SAME, *DEV Optional
POLLDECAY Fast poll decay 0-255, *SAME, *DEV Optional
SLOWPOLL Slow poll interval 0-99999, *SAME, *DEV Optional
DESTHOP Destination hop Values (up to 8 repetitions): Element list Optional
Element 1: Destination ID 4001-4FFE, 4001, *REMOVE
Element 2: Frequency 1, 2, 3, 4, 5, 900, 901, 902, 903, 904, 905, 906, 907, 908, 909, 910, 911
Element 3: Data rate *NONE, 1M, 2M
Element 4: Radio system identifier 000002-FFFFFE, 000002
BCDGRP Barcode group Values (up to 6 repetitions): Name, *SAME, *REMOVE Optional
TEXT Text 'description' Character value, *SAME, *REMOVE Optional
ENBKBDMAP Enable keyboard remapping *SAME, *NO, *YES Optional
ENBSCNFMT Enable screen reformatting *SAME, *NO, *YES Optional
DEVPFX Device name prefix Simple name, *SAME Optional

PTC group (PTCGRP)

Specifies the PTC group name to be changed. This name is used to identify configuration data related to a group of PTCs bound by the PTCRANGE parameter. The PTC group name is a unique alphanumeric character string up to 16 characters in length.

Initialization source member (INZMBR)

Specifies the extended wireless controller source file member containing the PTC entry that is changed.

Initialization source file (INZFILE)

Specifies the name of the source physical file that contains the extended wireless controller 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 the source physical file that contains the source member to be changed.

PTC ID range (PTCRANGE)

Specifies the beginning and ending 4-character decimal PTC ID to use for this PTC group. The defined configuration data is downloaded to any PTC detected within this range. A PTC group of a single PTC can be specified by setting the beginning and ending PTC ID to the same value.

The possible values are:

*SAME
The value remains the same.

The possible Beginning ID values are:

0001
The value 0001 is used as the beginning PTC ID of the PTC group.
begin-ID
Specify the beginning PTC ID of the PTC group. The valid values range from 0001 through 1022.

The possible Ending ID values are:

1022
The value 1022 is used as the ending PTC ID of the PTC group.
end-ID
Specify the ending PTC ID of the PTC group. The valid values range from 0001 through 1022.

Intensity (INTENSITY)

Specifies how the emulation screen on the PTC handles a field with the intensity attribute set.

The possible values are:

*SAME
The value remains the same.
*NORMAL
The field is displayed as normal.
*INVERSE
The field is displayed as reverse image.

Status line (STSLINE)

Specifies whether the status line is displayed on the PTC.

The possible values are:

*SAME
The value remains the same.
*YES
The status line is displayed.
*NO
The status line is not displayed.

Cursor type (CSRTYPE)

Specifies the type of cursor for use on the PTC.

The possible values are:

*SAME
The value remains the same.
*UNDERLINE
The cursor is an underline cursor.
*BLOCK
The cursor is a block cursor.

Inactivity timer (INACTTMR)

Specifies, in seconds, the inactivity timer value for the PTC. The PTC powers down if no activity occurs on the PTC for this length of time.

The possible values are:

*SAME
The value remains the same.
*DEV
The default device inactivity timer value is used.
inactivity-timer
Specify the inactivity timer value in seconds. The valid range of values is from 0 through 9999.

Backlight timer (BCKLTTMR)

Specifies, in seconds, the backlight inactivity timer value for the PTC. The PTC turns the backlight off if no activity occurs on the PTC for this length of time.

The possible values are:

*SAME
The value remains the same.
*DEV
The default device backlight inactivity timer value is used.
backlight-timer
Specify the backlight inactivity timer value in seconds. The valid range of values is from 0 through 9999.

Backlight key (BCKLTKEY)

Specifies whether the backlight turns on when a key is pressed on the PTC.

The possible values are:

*SAME
The value remains the same.
*ON
The backlight turns on when a key is pressed.
*OFF
The backlight does not turn on when a key is pressed

Bypass exit (BYPASSEXIT)

Specifies whether to bypass exit processing when leaving emulation on the PTC.

The possible values are:

*SAME
The value remains the same.
*NO
Exit processing runs.
*YES
Exit processing does not run.

Automatic run (AUTORUN)

Specifies whether emulation software is automatically run on the PTC at system IPL.

The possible values are:

*SAME
The value remains the same.
*NO
Emulation software does not automatically run at system IPL.
*YES
Emulation software automatically runs at system IPL.

Printer (PRINTER)

Specifies whether the printer for the PTC is the system printer or a printer that is locally attached to the PTC.

The possible values are:

*SAME
The value remains the same.
*SYSTEM
The system printer is used.
*PTC
The printer that is locally attached to the PTC is used.

Wand type (WANDTYPE)

Specifies the type of wand scanner being used.

The possible values are:

*SAME
The value remains the same.
*NONE
No wand scanner is used.
*PENCIL
A pencil wand scanner is used.
*LASER
A laser wand scanner is used.
*RS232
The wand scanner is attached on the RS-232 connector on the PTC

Wand pecking rate (PECKRATE)

Specifies the wand pecking rate, in milliseconds. This value sets the time interval between the wand power on and power off states that is used to detect whether a label is present.

The possible values are:

*SAME
The value remains the same.
*DEV
The default device wand pecking rate is used.
peck-rate
Specify the wand peck rate in milliseconds. Valid values are 2, 4, 8, 16, 32, and 48.

Laser read timer (LASERTMR)

Specifies the laser read timer value, in milliseconds. If a good scan has not been performed before the given timer value, then the laser is turned off.

The possible values are:

*SAME
The value remains the same.
*DEV
The default device laser read timer value is used.
laser-read-timer
Specify the laser read timer value in milliseconds. Valid values are 1440,2880,4320, and 5760.

Barcode function keys (BCDFKEY)

Specifies whether function keys are entered by bar code labels.

The possible values are:

*SAME
The value remains the same.
*NO
Function key entry by bar code is disabled.
*YES
Function key entry by bar code is enabled.

Auto Enter (AUTOENTER)

Specifies whether the PTC Auto Enter function is on or off.

The possible values are:

*SAME
The value remains the same.
*OFF
The Auto Enter function is disabled.
*ON
The Auto Enter function is enabled.

Cursor location (CSRLOC)

Specifies when the cursor is moved from one window chunk to another window chunk, if the cursor defaults to the first input field in the chunk or hold its relative position within the window. A chunk is defined as being a portion of the 5250 emulation screen equal to the size of the PTC display screen.

The possible values are:

*SAME
The value remains the same.
*HOLD
The cursor holds its position when moving from one window chunk to another.
*FIRST
The cursor moves to the first active field when moving from one window chunk to another.

Short scan (SHORTSCAN)

Specifies whether a bar code label that does not completely fill an input field is processed as if it has filled that field.

The possible values are:

*SAME
The value remains the same.
*YES
Bar code labels that do not fill an input field are processed as if they have filled the field.
*NO
Bar code labels must fill the input field before they are processed.

Scan end of file (SCANEOF)

Specifies whether an erase end of field is done when a bar code label is shorter than the input field.

The possible values are:

*SAME
The value remains the same.
*YES
An erase to end of field is done after a bar code scan.
*NO
An erase to end of field is not done after a bar code scan.

Fast poll interval (POLL)

Specifies, in milliseconds, the fast poll interval for the radio module on the PTC.

The possible values are:

*SAME
The value remains the same.
*DEV
The default device fast poll interval value is used.
poll-interval
Specify the fast poll interval in milliseconds. The valid range of values is from 0 through 9999.

Fast poll delay (POLLDLY)

Specifies, in milliseconds, the fast poll delay parameter for the PTC radio module.

The possible values are:

*SAME
The value remains the same.
*DEV
The default device fast poll delay value is used.
poll-delay
Specify the fast poll delay value in milliseconds. The valid range of values is from 0 through 9999.

Fast poll decay (POLLDECAY)

Specifies the fast poll decay for the PTC radio module. The valid range of values is from 0 through 255.

The possible values are:

*SAME
The value remains the same.
*DEV
The default device fast poll decay value is used.
poll-decay
Specify the fast poll decay value. The valid range of values is from 0 through 255.

Slow poll interval (SLOWPOLL)

Specifies, in milliseconds, the slow poll interval for the PTC radio module.

The possible values are:

*SAME
The value remains the same.
*DEV
The default device slow poll interval value is used.
slow-poll
Specify the slow poll interval in milliseconds. The valid range of values is from 0 through 99999.

Destination hop (DESTHOP)

Specifies the alternate destination ID (transport address) that the PTC attempts to connect to at emulation startup time. This is a four-element field and up to 8 destination hops can be specified.

The possible values are:

*SAME
The value remains the same.
*REMOVE
The four-elements of this destination hop are removed.

The possible Destiniation ID (Transport Address) values are:

destination ID
Specify the 4-byte hexadecimal destination ID of a wireless controller. The valid range of values is from 4001 through 4FFE.

Specifies which center frequency to use on the radio based on the radio channel set. The radio channel set is determined by the radio country code.

Valid values are from 1 to 5 for PTC's operating in the 2.4 Gigahertz range and 900 to 911 for PTC's operating in the 900 Megahertz range. If a value in the 900 to 911 range is used, the data rate may not be specified (900 Megahertz data rates are fixed by the frequency channel number).

The possible Frequency values for the 2.4 Gigahertz range are:

For channel set 9, there are five center frequencies.

1
A center frequency of 2.412 gigahertz is used.
2
A center frequency of 2.427 gigahertz is used.
3
A center frequency of 2.442 gigahertz is used.
4
A center frequency of 2.457 gigahertz is used.
5
A center frequency of 2.465 gigahertz is used.

For channel set 10, there are five center frequencies. Channel set 10 is used in ETSI (European Telecommunication and Standards Institute) countries.

1
A center frequency of 2.412 gigahertz is used.
2
A center frequency of 2.427 gigahertz is used.
3
A center frequency of 2.442 gigahertz is used.
4
A center frequency of 2.457 gigahertz is used.
5
A center frequency of 2.472 gigahertz is used.

For channel set 11, there is one center frequency.

1
A center frequency of 2.484 gigahertz is used.

For channel set 12, there are three center frequencies.

1
A center frequency of 2.457 gigahertz is used.
2
A center frequency of 2.465 gigahertz is used.
3
A center frequency of 2.472 gigahertz is used.

For channel set 13, there are three center frequencies.

1
A center frequency of 2.411 gigahertz is used.
2
A center frequency of 2.425 gigahertz is used.
3
A center frequency of 2.439 gigahertz is used.

The possible Frequency values for the 900 Megahertz range are: 900, 901, 902, 903, 904, 905, 906, 907, 908, 909, 910, and 911.

The possible Datarate values are:

Specifies the wireless LAN data rate.

2M
A wireless LAN data rate of 2 megabits per second is used.
1M
A wireless LAN data rate of 1 megabit per second is used.

The possible Sys-ID values are:

Specifies the 6-character hexadecimal radio system identifier to be used.

000002
The value 000002 is used.
sys-ID
Specify a system ID to be used. Valid values range from 000002 to FFFFFE in hexadecimal format and the last digit must be even (for example, 0, 2, 4, 6, 8, A, C, E).

Barcode group (BCDGRP)

Specifies the bar code group names used to define the bar code scanning capability of the PTC group. Bar code group names are defined and modified by the ADDEWCBCDE and CHGEWCBCDE commands.

The possible values are:

*SAME
The value remains the same.
*REMOVE
The specified bar code group is removed.
bar-code-group
Specify the bar code group name that corresponds to the bar code scanning capabilities required by the PTC. A maximum of 6 can be specified.

Text 'description' (TEXT)

Specifies text that briefly describes the PTC entry.

The possible values are:

*SAME
The value remains the same.
*REMOVE
Text is removed.
'description'
Specify no more than 50 characters of text, enclosed in apostrophes.

Enable keyboard remapping (ENBKBDMAP)

Enables or disables Keyboard Mapping function.

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

The possible values are:

*SAME
The value remains the same.
*NO
The Keyboard Mapping function is disabled.
*YES
The Keyboard Mapping function is enabled.

Enable screen reformatting (ENBSCNFMT)

Enables or disables Screen Reformatter function.

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

The possible values are:

*SAME
The value remains the same.
*NO
The Screen Reformatter function is disabled.
*YES
The Screen Reformatter function is enabled.

Device name prefix (DEVPFX)

Specifies a PTC Device Name Prefix. The is a 6 character alpha numeric string that can be used to uniquely identify PTC displays. It will be used in the following format: PPPPPPXXXX. PPPPPP is the 6 character prefix and XXXX is the PTC ID Range.

Examples 

CHGEWCPTCE   PTCGRP(PTC01)  INZMBR(EWC01)  INZFILE(QGPL/QEWCSRC)
             PTCRANGE(0001 0032)

This command changes a PTC group named PTC01 to use PTCs with addresses from 1 to 32 in the Extended Wireless Controller source file member EWC01 in source physical file QEWCSRC in QGPL.

Error messages

None