ADDEWCPTCE (Add Extended Wireless Controller PTC Entry) Command Description

ADDEWCPTCE Command syntax diagram

 

Purpose

The Add Extended Wireless Controller PTC Entry (ADDEWCPTCE) command adds a set of Portable Transaction Computer (PTC) group parameters to an extended wireless controller source file member. The PTC group parameters are the configurable PTC 5250 emulation operating parameters. These parameters are sent to each configured PTC at emulation startup. The Add Extended Wireless Controller Member (ADDEWCM) command must be run before this command to create the 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 to change values specified on the INZFILE and INZMBR parameters in the wireless controller description.

   
   

2. You must have *IOSYSCFG special authority to use this command.

 

Required Parameters

PTCGRP

Specifies the PTC group name to be added. 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 in which the PTC entry is added. The PTC configuration data is added to this member.

 

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.

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.

Element 1: Beginning ID

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 (decimal).

Element 2: Ending ID

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 (decimal).

INTENSITY

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

*NORMAL: The field is displayed as normal.

*INVERSE: The field is displayed in reverse image.

STSLINE

Specifies whether the status line is displayed on the PTC.

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

*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 will power down if no activity occurs on the PTC during this time period.

*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 during this time period.

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

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

*NO: Exit processing runs.

*YES: Exit processing does not run.

AUTORUN

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

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

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

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

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.

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

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

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

*ON: The Auto Enter function is on.

*OFF: The Auto Enter function is off.

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.

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

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

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

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

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

*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 radio module on the PTC.

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

*NONE: No destination hops are identified.

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 Channel Number

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.

*NONE: No bar code group names are defined for this PTC group.

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.

*BLANK: Text is not specified.

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

Example for ADDEWCPTCE

ADDEWCPTCE   PTCGRP(PTC01)  INZMBR(EWC01)
  PTCRANGE(0001 0020)

This command adds the configuration parameters for the PTC for a PTC group named PTC01 for PTCs with addresses from 1 to 20 to the extended wireless controller source file member EWC01 in source physical file QEWCSRC in the library list.

Error messages for ADDEWCPTCE

None