Uuencode (com.ibi.agents.XDUUPreEmitter)

Syntax:

com.ibi.agents.XDUUPreEmitter

Description:

This pre-emitter allows you to Uuencode the document prior to it being emitted by iWay Service Manager. If you are sending an email with an attachment and you suspect your recipient(s) may not have a MIME-compliant system (for example, an older PC or UNIX system), you can specify Uuencode for the attachment to an email note.

Parameters:

Parameter

Description

File Name

File Name to be used in the UUENCODED header.

Note: This entry is informational only and does not necessarily represent a physical file accessible to the Service Manager. Rather, it is included in the Uuencode header information that is generated.

Example:

The following example shows a simple flat text input document containing flat text:

Test!
Gentle Reader:
This is nothing more than a test file created to provide fodder for the various encoding schemes. If you are using it to test, congratulations on
your agility in cutting, pasting, saving, and decoding using WinZip.
Enjoy!

The output document appears as shown below:

begin 666 encoded.txt
M5&5S="$-"@T*1V5N=&QE(%)E861E<CH-"@T*5&AI<R!I<R!N;W1H:6YG(&UO
M<F4@=&AA;B!A('1E<W0@9FEL92!C<F5A=&5D('1O('!R;W9I9&4@9F]D9&5R
M(&9O<B!T:&4@=F%R:6]U<R!E;F-O9&EN9R!S8VAE;65S+B!)9B!Y;W4@87)E
M('5S:6YG(&ET('1O('1E<W0L(&-O;F=R871U;&%T:6]N<R!O;B!Y;W5R(&%G
M:6QI='D@:6X@8W5T=&EN9RP@<&%S=&EN9RP@<V%V:6YG+"!A;F0@9&5C;V1I
:;F<@=7-I;F<@5VEN6FEP+@T*#0I%;FIO>2$`
`
end

iFL Function:

_uudecode

Using the uudecoding function converts a string from a uuencode buffer back into the original text (or data) representation. This function works on either a fixed uuencoded buffer or data obtained from iWay Service Manager using an iFL function such as _FILE to read in the data.

The following table shows the values and descriptions of the _uudecode functions.

Parameters

Descriptions

String

Value to convert (optional).

Note: If a value is not provided, then the current document will be used for input.

String

Encoding used to convert recovered bytes to a string.

Example:

The following example uses the _file iFL function to load the file data into the first parameter of the _uudecode function. This is shown in the uusample.dat file.

begin 644 encoded.txt
M5&5S="$-"@T*1V5N=&QE(%)E861E<CH-"@T*5&AI<R!I<R!N;W1H:6YG(&UO
M<F4@=&AA;B!A('1E<W0@9FEL92!C<F5A=&5D('1O('!R;W9I9&4@9F]D9&5R
M(&9O<B!T:&4@=F%R:6]U<R!E;F-O9&EN9R!S8VAE;65S+B!)9B!Y;W4@87)E
M('5S:6YG(&ET('1O('1E<W0L(&-O;F=R871U;&%T:6]N<R!O;B!Y;W5R(&%G
M:6QI='D@:6X@8W5T=&EN9RP@<&%S=&EN9RP@<V%V:6YG+"!A;F0@9&5C;V1I
:;F<@=7-I;F<@5VEN6FEP+@T*#0I%;FIO>2$!
end

The _uudecode function then converts the buffer into the following uudecoded string:

Test!
Gentle Reader:
This is nothing more than a test file created to provide fodder for the various encoding schemes. If you are using it to test, congratulations on
your agility in cutting, pasting, saving, and decoding using WinZip.
Enjoy!