Paxar Gold 6037EX User Manual

Size:
2.78 Mb
Download

u r d

Description

Deletes a directory on the printer. If the directory does not exist, an error occurs.

Syntax

urd directory

Parameters

directory A directory name (and optionally, the path).

Example

urd backups

deletes the backups subdirectory from the current directory.

u r u n

Description

Runs a DOS command or program on the printer. UServe runs beneath this offshoot task. When the command or program ends, UServe is still running.

Running this command is the one case of where you would use the printer, rather than only using UClient.

If you run a program (such as Diagnostics) on the printer, Command Failed. Did not receive a response from the Ultraappears on the UClient

screen. This error is nothing to worry about. It should not occur, though, when running DOS commands with urun.

Syntax

urun command

Parameters

command The command or program name, along with any necessary parameters.

Using UServe and UClient 7-21

Example

urun diag

runs the printer’s diagnostics program as an offshoot task from UServe.

u v i e w

Description

Displays a file’s contents on the printer.

Syntax

uview file

Parameters

file

The name (and optionally, the path) of the file to display.

Example

uview test.txt

displays the contents of test.txt. Following is an example:

test.txt:

This is a test.

U w d

Description

Displays the path to the current directory on the printer.

Syntax

uwd

Parameters

None

7-22Programmer’s Manual

Example

uwd

displays the path to the current directory on the printer. For example,

D:\DATA

T r o u b l e s h o o t i n g

Consult the following table if any errors occur while you are using UClient and UServe. The messages can appear individually or together. They are listed alphabetically.

Message

Solution

 

 

Cannot find the requested file.

Verify that the specified file exists

 

and you spelled its name correctly.

 

Then, retry the command.

Command Failed.

Verify that a valid PC/printer

 

connection exists. If so, then verify

 

the syntax and parameters of the

 

command and re-tryit.

Connection Closed to Ultra

You tried to close a PC/printer

 

connection that already is closed.

Connection to the Ultra has not

Establish a PC/printer connection.

been opened

See “Establishing a PC/Printer

 

Connection.”

Could not create directory:

There is not enough disk space to

 

create a directory. Free some space

 

before trying again.

Could not delete file:

You specified a non-existentfile with

 

the command. Verify the spelling of

 

the name and try again.

Could not establish a

Reboot the printer and re-establish

connection with the Ultra.

the PC/printer connection. If this

 

error still occurs, have the printer

 

serviced.

Using UServe and UClient 7-23

Message

Solution

 

 

Could not get the file.

Verify that a valid PC/printer

 

connection exists. If so, verify the

 

syntax of the command and retry it.

Could not put the file.

Verify that a valid PC/printer

 

connection exists. If so, verify the

 

syntax of the command. Then, retry

 

the command.

Could not remove directory:

Verify that the directory you specified

 

exists and retry the command.

Could not save file locally.

There is not enough space on the PC

 

to save a file received from the

 

printer. Free some space and retry

 

the command.

Did not receive a response from

Verify that a valid PC/printer

the Ultra.

connection exists. If so, increase the

 

length of the timeout. Then retry the

 

command.

 

From the user perspective, a

 

command may finish running, but

 

there can still be processing going

 

on behind the scenes before the

 

command is truly finished. A timeout

 

can occur during this timeframe.

 

Therefore, when a timeout error

 

occurs, check to see if the command

 

actually finished or not before trying

 

to correct the problem. For example,

 

if the error occurred on a put, verify

 

that the file copy completed.

Error Running command on

A ROM-DOSerror occurred on the

Ultra. Returned Error = xxx

printer. Retry the command. If the

 

same error occurs, re-bootthe

 

printer and/or have it serviced.

7-24Programmer’s Manual

 

Message

Solution

 

 

Invalid Parameters for command

Verify the syntax of the command

 

and retry it with all of the

 

parameters.

No Connection is present with

Establish a PC/printer connection.

Ultra.

 

No directory was specified.

Verify the syntax of the command

 

and enter a directory name where

 

specified.

No File Specified.

A file name parameter was left blank.

 

Retry the command, listing a file

 

name.

No Files could be found.

The file you specified in the

 

command does not exist. Verify the

 

correct name and/or spelling and

 

retry the command.

No matching files found.

You specified file names with a wild

 

card, and there are none fitting the

 

specification. Verify the file names

 

and spelling and retry the command.

Open Failed.

UServe is not running on the printer.

 

Start it and establish a PC/printer

 

connection.

Response could not be read

Verify that a valid PC/printer

from Ultra

connection exists and retry the

 

command.

Request could not be sent to the

Verify that a valid PC/printer

Ultra.

connection exists and retry the

 

command.

Soft Reboot Failed.

Verify that a valid PC/printer

 

connection exists and retry the

 

command.

Sum check received from the

Verify that a valid PC/printer

Ultra was invalid.

connection exists and retry the

 

command.

 

Using UServe and UClient 7-25

Message

Solution

 

 

Supplied Buffer was too small

Call Technical Support at the phone

for amount of data.

number on the back of this manual.

Ultra returned Negative

The printer timed out before it could

response.

complete the command. Increase

 

the length of the timeout with the

 

settimeout command and retry the

 

command that timed out.

Unknown Command

Verify the spelling of the command

 

name and re-enterit.

Unknown Drive Letter

Retry the udiskfree command, but

 

specify either c ord as the drive

 

letter.

Unknown Error (Error = xxx).

A UServe error occurred. Physically

 

reboot the printer (not with the

 

reboot command), start UServe, and

 

try the command again. If the error

 

still occurs, have the printer

 

serviced.

7-26Programmer’s Manual

S A M P L E A P P L I C A T I O N S

A

The SDK contains several sample applications for both printers for you to study as you write your own applications. These samples are located in the SDK’s samples sub-directory.This appendix describes these samples.

Following are the samples discussed:

Sample #

Description

 

 

1

Prints with the trigger.

2

Prints with the on-demandsensor.

3

Prints a strip of labels.

4

Prints using fonts and formats loaded with pclOpen.

5

Uses the scanner.

6

Scans and prints.

7

Scans specific bar codes and prints.

 

 

Sample Applications A-1

S a m p l e 1

F u n c t i o n

Prints with the trigger.

A l g o r i t h m

1. Initialize the Print subsystem without allocating font storage memory.

2. Loads a format packet.

3. Performs the following until the operator presses the trigger (to print), b (to break out of the loop), or f+0 to calibrate supplies.

A. Checks whether the battery is charged enough for printing.

B. Loads a batch packet and prints the format.

C. Waits until the label prints by checking the status repeatedly until it returns something other than “busy.”

4. Closes the Print subsystem.

S a m p l e 2

F u n c t i o n

Prints using the on-demandsensor.

A l g o r i t h m

1. Initializes the Print subsystem without allocating font storage memory.

2. Loads a format packet. This format defines the feed mode ason-demand.

3. Checks whether the battery is charged enough for printing.

4. Loads a batch packet and prints the format.

A-2Programmer’s Manual

5. Waits until the label prints by checking the status repeatedly until it returns something other than “busy.”

6. Closes the Print subsystem.

S a m p l e 3

F u n c t i o n

Prints a strip of labels.

A l g o r i t h m

1. Initializes the Print subsystem without allocating font storage memory.

2. Loads a format packet.

3. Performs the following until an error occurs

A. Checks whether the battery is charged enough for printing.

B. Prompts the operator to enter a quantity and builds the batch dynamically with that number and other data.

C. Builds the batch and prints the label(s).

D. Waits until the labels print by checking the status repeatedly until it returns something other than “busy.”

3. Closes the Print subsystem.

Sample Applications A-3

S a m p l e 4

F u n c t i o n

Prints using fonts and formats loaded with pclOpen.

A l g o r i t h m

1. Initializes the Print subsystem.

2. Loads FORMATS.PCL. This file contains an MPCL format packet.

3. Performs the following until the operator presses the trigger (to print), b (to break out of the loop), or f+0 to calibrate supplies.

A. Waits for the operator to press the trigger.

B. Checks whether the battery is charged enough for printing.

C. Loads a batch packet.

D. Waits until the label prints by checking the status repeatedly until it returns something other than “busy.”

4. Closes the Print subsystem.

S a m p l e 5

F u n c t i o n

Uses the scanner.

A l g o r i t h m

1. Enables the scanner.

2. Waits for the operator to press the trigger. Pressing b breaks out of the waiting loop (without performing a scan).

3. Initiates a scan.

4. Disables the scanner.

A-4Programmer’s Manual