Add EWC PTC Entry (ADDEWCPTCE)

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.

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.

Parameters

Keyword Description Choices Notes
PTCGRP PTC group Name Required, Positional 1
INZMBR Initialization source member Name Required, Positional 2
INZFILE Initialization source file Qualified object name Optional, 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, 0001
Element 2: End ID 0001-1022, 1022
INTENSITY Intensity *NORMAL, *INVERSE Optional
STSLINE Status line *YES, *NO Optional
CSRTYPE Cursor type *UNDERLINE, *BLOCK Optional
INACTTMR Inactivity timer 0-9999, *DEV Optional
BCKLTTMR Backlight timer 0-9999, *DEV Optional
BCKLTKEY Backlight key *ON, *OFF Optional
BYPASSEXIT Bypass exit *YES, *NO Optional
AUTORUN Automatic run *YES, *NO Optional
PRINTER Printer *SYSTEM, *PTC Optional
WANDTYPE Wand type *NONE, *PENCIL, *LASER, *RS232 Optional
PECKRATE Wand pecking rate *DEV, 2, 4, 8, 16, 32, 48 Optional
LASERTMR Laser read timer *DEV, 1440, 2880, 4320, 5760 Optional
BCDFKEY Barcode function keys *OFF, *ON Optional
AUTOENTER Auto Enter *OFF, *ON Optional
CSRLOC Cursor location *HOLD, *FIRST Optional
SHORTSCAN Short scan *YES, *NO Optional
SCANEOF Scan end of file *YES, *NO Optional
POLL Fast poll interval 0-9999, *DEV Optional
POLLDLY Fast poll delay 0-9999, *DEV Optional
POLLDECAY Fast poll decay 0-255, *DEV Optional
SLOWPOLL Slow poll interval 0-99999, *DEV Optional
DESTHOP Destination hop Single values: *NONE
Other values (up to 8 repetitions): Element list		 Optional
Element 1: Destination ID 4001-4FFE
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 Single values: *NONE
Other values (up to 6 repetitions): Name		 Optional
TEXT Text 'description' Character value, *BLANK Optional
ENBKBDMAP Enable keyboard remapping *NO, *YES Optional
ENBSCNFMT Enable screen reformatting *NO, *YES Optional
DEVPFX Device name prefix Simple name, QWLS Optional

PTC group (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 in length.

Initialization source member (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.

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.

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 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:

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

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

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

The possible values are:

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

The possible values are:

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

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

*NO
Exit processing runs.
*YES
Exit processing does not run.

Automatic run (AUTORUN)

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

The possible values are:

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

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

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

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

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

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

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

The possible values are:

*HOLD
Cursor holds its position when moving from one window chunk to another.
*FIRST
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:

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

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

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

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

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

The possible values are:

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

*NONE
No destination hops are identified.

The possible Destination ID (Tranport 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:

*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 'description' (TEXT)

Specifies text that briefly describes the PTC entry.

The possible values are:

*BLANK
Text is not specified.
'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:

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

*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 

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

None