CHGEWCPTCE (Change Extended Wireless Controller PTC Entry) Command Description

CHGEWCPTCE Command syntax diagram

 

Purpose

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.

 

Restrictions

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

   Note:

   Use the Change Controller Description (Local Work Station) (CHGCTLLWS) command to view or change values specified on the INZFILE and INZMBR parameters in the wireless controller description.

   
   

2. When prompting on this command, a *DEV value shown for 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.
   
3. You must have *IOSYSCFG special authority to use this command.

 

Required Parameters

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 with a maximum of 16 characters.

INZMBR

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

 

Optional Parameters

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.

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.

PTCRANGE

Specifies the beginning and ending PTC Id value to use for this PTC group. The defined configuration data is downloaded to any PTC detected within this range. A PTC group of one can be specified by setting the beginning and ending PTC Id to the same value.

*SAME: The value remains the same.

Element 1: Beginning ID

begin-identifier: Specify the beginning PTC identifier value of the PTC group. The valid values range from 0001 through 1022 (decimal).

Element 2: Ending ID

end-identifier: Specify the ending PTC identifier value of the PTC group. The valid values range from 0001 through 1022 (decimal).

INTENSITY

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

*SAME: The value remains the same.

*NORMAL: The field is displayed as normal.

*INVERSE: The field is displayed as reverse image.

STSLINE

Specifies whether the status line is displayed on the PTC.

*SAME: The value remains the same.

*YES: The status line is shown.

*NO: The status line is not shown.

CSRTYPE

Specifies the type of cursor to be shown on the PTC.

*SAME: The value remains the same.

*UNDERLINE The cursor is an underline cursor.

*BLOCK: The cursor is a block cursor.

INACTTMR

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

*SAME: The value remains the same.

*DEV The default device inactivity timer value is used.

inactivity-timer: Specify the inactivity timer value in minutes. The valid range of values is from 0 through 9999.

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.

*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.

BCKLTKEY

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

*SAME: The value remains the same.

*YES: The backlight turns on when a key is pressed.

*NO: The backlight does not turn on when a key is pressed

BYPASSEXIT

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

*SAME: The value remains the same.

*NO: Exit processing runs.

*YES: Exit processing does not run.

AUTORUN

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

*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

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

*SAME: The value remains the same.

*SYSTEM: The system printer is used.

*PTC: The printer that is locally attached to the PTC is used.

WANDTYPE

Specifies the type of wand scanner being used.

*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 to the RS-232 connector on the PTC.

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.

*SAME: The value remains the same.

*DEV The default device wand pecking rate is used.

peck-rate: Specify the wand pecking rate in milliseconds. Valid values are 2, 4, 8, 16, 32, and 48.

LASERTMR

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

*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.

BCDFKEY

Specifies whether function keys can be entered by bar code labels.

*SAME: The value remains the same.

*NO: Function key entry by bar code is disabled.

*YES: Function key entry by bar code is enabled.

AUTOENTER

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

*SAME: The value remains the same.

*OFF: The Auto Enter function is off.

*ON: The Auto Enter function is on.

CSRLOC

Specifies the new position of the cursor when the cursor is moved from one window chunk to another window chunk. A chunk is defined as being a portion of the 5250 emulation screen equal to the size of the PTC display screen.

*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.

SHORTSCAN

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

*SAME: The value remains the same.

*YES: Bar code labels that do not fill an input field are processed as if they had filled the field.

*NO: Bar code labels must fill the input field before they are processed.

SCANEOF

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

*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.

POLL

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

*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.

POLLDLY

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

*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.

POLLDECAY

Specifies the fast poll decay for the PTC radio module.

*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.

SLOWPOLL

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

*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.

DESTHOP

Specifies alternate controller destination id's and radio parameters to which the PTC attempts to connect if the primary one becomes unavailable. This is a four-element field and a maximum of 8 destination hops can be specified.

*SAME: The value remains the same.

*REMOVE: The four elements of this destination hop are removed.

Element 1: Controller Destination ID

4001: The value 4001 is used.

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

Element 2: Frequency

Specifies which center frequency to use on the direct sequence radio. Frequencies are referenced by channel number since the exact frequency value may change from country to country.

1: Frequency channel number 1 is used.

frequency-channel-number: Specify the frequency channel number. Valid values are from 1 to 5 and 901 to 911. The 1 to 5 range applies only to PTCs operating in the 2.4 Ghz range. The 901 to 911 range applies only to PTCs operating in the 900 Mhz range. If a value in the 901 to 911 range is used, the data rate may not be specified (900 Mhz data rates are fixed by the frequency channel number).

Element 3: Data Rate

Specifies the wireless LAN data rate.

*NONE: No data rate is specified.

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.

Element 4: System-ID

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

000002: The value 000002 is used.

system-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).

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 Add Extended Wireless Controller Bar Code Entry (ADDEWCBCDE) command or the Change Wireless Controller Bar Code Entry (CHGEWCBCDE) command.

*SAME: The value remains the same.

*REMOVE: The bar code groups defined for this PTC group are 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

Specifies text that briefly describes the PTC entry.

*SAME: The value remains the same.

*REMOVE: The text describing the PTC entry is removed.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Example for CHGEWCPTCE

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 for CHGEWCPTCE

*ESCAPE Messages

None.