Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Verso
7
Manual de Referncia
AWDP107087
ACL
50 Kallang Avenue
#07-05 Noel Corporate Building
Singapore 339505
Tel: +65-299-3350 Fax: +65-299-5110
E-mail: info_asia@acl.com Web: www.acl.com
para Windows
Manual de Referncia
Verso
Manual de Referncia
Verso
Nenhuma parte desta publicao pode ser reproduzida, armazenada em sistema de busca ou transmitida
sob qualquer forma ou por qualquer meio (fotocpia, eletrnico, mecnico, gravao ou outro), sem a
permisso por escrito da editora, exceto por crticos, que podero citar trechos curtos em resenhas.
Este manual poder conter informaes datadas. O uso deste material dever ser feito compreendendo-se
que este manual pode no conter todas as informaes, ou as informaes mais atuais relevantes para a
situao ou aplicao pretendida. Os servios de suporte e atualizao esto disponveis na ACL, atravs de
um contrato impresso separado.
Impresso no Canad 10 9 8 7 6 5 4 3 2 1
ACL e Audit Command Language so marcas registradas da ACL ou de uma de suas subsidirias ou de
seus licenciadores. Microsoft, Windows, o logotipo do Windows, e Windows NT so marcas registradas da
Microsoft Corporation. SAP uma marca registrada da SAP AG. Outras marcas ou produtos
mencionados no software, ou associados a ele, so marcas comerciais ou marcas registradas de seus
respectivos proprietrios, devendo ser tratadas como tal.
O uso de um termo neste manual no deve ser interpretado como se afetasse a validade de qualquer marca
registrada ou de servio.
iii
ndice
Sobre este manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
iv
ndice
20
21
22
22
22
Captulo 2: Funes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Resumo das funes ..............................................................................
ABSOLUTE( ) ........................................................................................
AGE( ) ....................................................................................................
ALLTRIM( ) ...........................................................................................
ASCII( ) ..................................................................................................
AT( ) .......................................................................................................
BETWEEN( ) .........................................................................................
BIT( ) ......................................................................................................
BLANKS( ) .............................................................................................
BYTE( ) ..................................................................................................
CDOW( ) ...............................................................................................
CHR( ) ....................................................................................................
CLEAN( ) ...............................................................................................
CTOD( ) .................................................................................................
DATE( ) ..................................................................................................
DECIMALS( ) ........................................................................................
DIGIT( ) .................................................................................................
DOW( ) ..................................................................................................
EBCDIC( ) .............................................................................................
EFFECTIVE( ) .......................................................................................
EXCLUDE( ) ..........................................................................................
EXPONENT( ) .......................................................................................
FILESIZE( ) ............................................................................................
FIND( ) ...................................................................................................
FREQUENCY( ) ....................................................................................
FTYPE( ) ................................................................................................
FVANNUITY( ) .....................................................................................
FVLUMPSUM( ) ...................................................................................
HEXADECIMAL( ) ...............................................................................
INCLUDE( ) ...........................................................................................
INSERT( ) ..............................................................................................
INTEGER( ) ...........................................................................................
23
28
28
29
29
30
32
33
35
35
36
36
37
38
39
40
41
42
42
43
44
44
45
46
47
48
49
50
51
52
52
53
ndice
ISBLANK( ) ............................................................................................ 53
LAST( ) ................................................................................................... 54
LEADING( ) ........................................................................................... 55
LENGTH( ) ............................................................................................. 55
LOGARITHM( ) ..................................................................................... 56
LOWER( ) ............................................................................................... 57
LTRIM( ) ................................................................................................ 57
MAP( ) .................................................................................................... 58
MASK( ) .................................................................................................. 59
MATCH( ) .............................................................................................. 60
MAXIMUM( ) ........................................................................................ 61
MINIMUM( ) ......................................................................................... 62
MOD( ) ................................................................................................... 63
NOMINAL( ) .......................................................................................... 63
NPER( ) .................................................................................................. 64
OCCURS( ) ............................................................................................. 65
OFFSET( ) ............................................................................................... 65
PACKED( ) ............................................................................................. 66
PMT( ) .................................................................................................... 67
PROPER( ) .............................................................................................. 68
PVANNUITY( ) ..................................................................................... 68
PVLUMPSUM( ) .................................................................................... 69
RAND( ) ou RND( ) ............................................................................... 70
RATE( ) .................................................................................................. 70
RECLEN( ) .............................................................................................. 71
RECNO( ) ............................................................................................... 72
REMOVE( ) ............................................................................................ 73
REPEAT( ) .............................................................................................. 74
REPLACE( ) ........................................................................................... 74
REVERSE( ) ............................................................................................ 76
RJUSTIFY( ) ........................................................................................... 76
ROOT( ) .................................................................................................. 76
ROUND( ) .............................................................................................. 77
SHIFT( ) .................................................................................................. 77
SOUNDEX( ) .......................................................................................... 78
SOUNDSLIKE( ) .................................................................................... 79
SPLIT( ) .................................................................................................. 79
STRING( ) .............................................................................................. 80
SUBSTRING( ) ....................................................................................... 81
vi
ndice
TEST( ) ...................................................................................................
TIME( ) ..................................................................................................
TRANSFORM( ) ....................................................................................
TRIM( ) ..................................................................................................
UNSIGNED( ) ........................................................................................
UPPER( ) ................................................................................................
VALUE( ) ...............................................................................................
VERIFY( ) ..............................................................................................
ZONED( ) ..............................................................................................
ZSTAT( ) ................................................................................................
82
82
84
84
85
85
86
87
87
88
ndice
To (Para) ...............................................................................................
Use Output File (Usar arquivo de sada) .............................................
While (Enquanto) ................................................................................
Width (Largura) ...................................................................................
111
112
112
114
vii
viii
ndice
ndice
ix
ndice
ndice
xi
xii
ndice
ndice
xiii
xiv
ndice
Funes do ACL
Comandos do ACL
Publicaes relacionadas
Guia do usurio do ACL para Windows
O Guia do Usurio do ACL para Windows ir ajudar no uso inicial do
ACL para Windows Verso 7. Ele mostra como:
Usar o ACL para Windows Verso 7 juntamente com o ACL for OS/390 em um
ambiente cliente/servidor
Itlico com
Indica itens especificados pelo usurio, como nomes de campos.
espaamento simples
Parnteses
angulados < >
Chaves { }
Barras
Reticncias...
Precisa de ajuda?
Recursos
Para assistncia no uso do ACL, consulte estes recursos adicionais:
Caso no consiga encontrar a soluo para seu problema e se voc for um usurio com
direito a suporte, entre em contato com a ACL para obter assistncia. Antes de entrar em
contato, certifique-se de ter em mos as seguintes informaes:
O nmero de srie do ACL. Voc encontra esse nmero no verso da caixa de seu
CD ou no ACL para Windows Verso 7. Selecione Ajuda na barra de menus e
escolha Sobre o ACL.
Tipo de hardware que voc est usando e se est conectado a uma Rede Local
(LAN).
Uma descrio da ocorrncia e o que voc estava fazendo quando o problema
ocorreu.
A mensagem de erro, se houver, exibida pelo ACL.
Telefone: +1-604-669-4997
Fax: +1-604-689-4209
E-mail: support@acl.com
Telefone: +32-2-642-22-90
Fax: +32-2-642-22-91
E-mail: support_europe@acl.com
Telefone: +65-299-3350
Fax: +65-299-5110
E-mail: support_asia@acl.com
Queremos ouvi-lo!
A ACL compromete-se com o fornecimento de produtos e servios de qualidade para
acesso, anlise e relatrios de dados. Para garantir sua satisfao contnua, aguardamos
suas sugestes de melhorias do ACL para Windows, da nossa documentao dos
usurios e da Ajuda on-line.
Envie seus comentrios para nossa equipe de gerenciamento de produtos para:
Telefone: +1-604-669-4225
Fax: +1-604-669-3557
E-mail: product_mgmt@acl.com
Captulo 1
T IPOS DE CAMPO
O ACL reconhece todos os tipos de dados das fontes mais comuns e atribui, automaticamente, um tipo de campo do ACL correspondente. Cada tipo de campo do ACL tem
uma categoria de dados correspondente.
Categorias de dados
Muitos esquemas foram desenvolvidos para representar categorias de dados com cdigo
binrio. Esses esquemas de codificao so largamente agrupados em quatro categorias:
Caractere, Numrico, Lgico e Data. No ACL, essas categorias so, algumas vezes,
representadas pelas letras C, N, L e D.
Dados de caractere
Os dados de caractere normalmente so utilizados para representar as cadeias de texto
ou informaes de datas. Quando aparecer em dgitos em um campo de caractere, eles
sero tratados como caracteres de texto, no como nmeros.
Dados numricos
Um grande nmero de tipos de dados foi desenvolvido para representar dados
numricos. O ACL l quase qualquer tipo de dados numricos e interpreta automaticamente a maioria dos tipos de dados no-proprietrios.
Dados lgicos
Os dados lgicos tm somente dois valores; um para representar Verdadeiro e outro
para representar Falso. Os dados lgicos normalmente so armazenados em um campo
de caractere, em um formato igual a T/F, S/N ou Ligado/Desligado. s vezes, ele
armazenado em um campo numrico ou de caractere, onde zero indica Falso e qualquer
outro valor indica Verdadeiro.
O ACL reconhece a maioria dos dados lgicos automaticamente.
Dados de data
As informaes sobre data so normalmente armazenadas como dados de caractere e,
s vezes, como dados numricos.
5
Manual de Referncia
Character (Caractere)
ASCII
EBCDIC
Custom (Personalizado)
PCASCII
Numeric (Numrico)
ACL
ACCPAC
BASIC
Binary (Binrio)
Float (Ponto flutuante)
Halfbyte (Meio byte)
IBMFloat (Ponto flutuante da IBM)
Micro
Numeric (Numrico)
Packed (Compactado)
Print (Imprimir)
Unisys
Captulo 1
Tipos de campo
Dados de origem e tipos de campo do ACL
Categoria de dados
Logical (Lgica)
Logical (Lgico)
Date (Data)
Date (Data)
Character (Caractere)
ASCII ou EBCDIC
PIC X (COBOL)
ASCII ou EBCDIC
ASCII ou EBCDIC
Binary (Binrio)
Packed (Compactado)
Zoned (Zonado)
Binary (Binrio)
Manual de Referncia
Packed (Compactado)
Micro (comprimento 2)
Long (Largo)
Real
BASIC (comprimento 4)
BASIC (comprimento 8)
ACCPAC
L campos numricos de arquivos de dados ACCPAC.
Esse tipo de campo se refere ao formato numrico usado nos pacotes de contabilidade
ACCPAC. O comprimento desse campo de dados tem sempre 6 bytes (o ACL substitui
qualquer outro comprimento especificado).
ACL
L os valores dos campos calculados e das variveis armazenadas em um arquivo de
dados gerado pelo ACL.
O tipo de campo do ACL um campo de 8 ou 12 bytes que armazena os resultados e
clculos do ACL. Ele se destina ao armazenamento de grandes nmeros e no um
campo que pode ser impresso.
No necessrio definir um tipo de campo do ACL, porque o ACL o faz automaticamente.
ASCII
L dados codificados de acordo com a tabela ASCII (American Standard Code for
Information Interchange).
Captulo 1
Tipos de campo
BASIC
BASIC
L dados numricos gerados pelo BASIC interpretativo.
Esse tipo de campo especifica o padro BASIC (IBM PC) interpretativo adotado pela
maioria dos softwares de microcomputadores de linguagem BASIC para representao
de ponto flutuante. Entretanto, difere dos coprocessadores matemticos 8087 e 80287,
as CPUs 486 e Pentium e da maioria de outros softwares de PC.
Como norma para os tipos de campo numricos de microcomputador, o byte de menos
significativo do significando (mantissa) o primeiro a ser seqencialmente armazenado
at o byte mais significativo do expoente. Em outras palavras, os bytes so armazenados
em ordem inversa. O comprimento desse tipo de campo de 4 ou 8 bytes, como
definido pelo padro. Consulte Float (Ponto flutuante) na pgina 15 para obter uma
descrio do formato 8087 do Institute of Electrical and Electronic Engineers (IEEE).
Binary (Binrio)
L dados binrios numricos sem sinal, correspondentes ao tipo de campo fixed binary,
PL/1 ou ao tipo de dados COMPUTATIONAL-1 do COBOL.
Binary interpretado como um nmero, com o byte mais significativo vindo primeiro
(extremo esquerdo) e o byte menos significativo por ltimo, como norma nos dados
de mainframe. Esse tipo de campo no adequado aos campos binary (inteiros) dos
Micros, que geralmente armazenam o byte menos significativo primeiro. O equivalente
ao Binary dos micros o tipo de campo Micro.
O comprimento do tipo de campo binary tem no mximo 8 bytes. O nmero de casas
decimais o nmero implcito de dgitos decimais e no pode exceder o nmero de
dgitos especificados pelo comprimento.
Os campos binary de comprimento par so tratados como campos binrios com sinal
(complemento de dois) e os de comprimento mpar so tratados como campos sem
sinal (bytes zero de ordem superior implcitos so adicionados).
10
Manual de Referncia
Custom (Personalizado)
L conjuntos de caracteres no padro. O tipo de dado custom pode ser til em aplicativos de idioma estrangeiro onde determinados caracteres so implementados de uma
forma fora dos padres comuns.
Como padro, o tipo de dado custom ASCII. Entretanto, possvel criar um arquivo
especial denominado custom.dat que contm valores substitutos para qualquer ou
todos os valores de caracteres ASCII padro. No h restries nas substituies de
caractere que podem ser feitas.
possvel criar o arquivo custom.dat usando qualquer editor de texto. Inclua o arquivo
no mesmo diretrio onde esto os arquivos executveis do ACL.
Custom.dat um arquivo de texto-padro com dois valores em cada linha. O primeiro
valor o caractere a ser substitudo; o segundo valor o caractere que o substituir. Os
valores podem ser especificados como caracteres, valores decimais ou hexadecimais:
Qualquer uma dessas trs convenes pode ser usada individualmente ou em combinao.
O arquivo custom.dat lido quando o ACL iniciado. Desse modo voc no poder
edit-lo enquanto o ACL estiver sendo executado. Nenhum dos valores especificados no
custom.dat deve exceder 255, que o maior valor que pode ser armazenado em um byte.
possvel usar qualquer editor de texto para exibir o arquivo custom.dat.
Por exemplo, se o campo de dados a ser lido estiver em ASCII, mas o sistema usar um
hexadecimal A4 para um sinal de cifro ($), um hexadecimal A5 para uma vrgula e um
nmero decimal 5 para um ponto decimal, voc poder defini-lo como um campo
custom. O contedo do arquivo custom.dat seria:
XA4C$
XA5C,
5C.
Captulo 1
Tipos de campo
Date (Data)
11
Date (Data)
Interpreta as informaes sobre data e as converte para o tipo de campo de data do ACL.
Para o ACL reconhecer as informaes sobre data, elas devem ser armazenadas em um
formato descomprimido e ser reconhecveis como informaes sobre data no arquivo
de dados fonte.
As informaes sobre data so armazenadas de vrias maneiras. As datas geralmente
so representadas por uma combinao de caracteres, nmeros e caracteres de
pontuao. s vezes as datas so representadas somente por nmeros. O ACL reconhece
automaticamente as informaes sobre data na maioria dos arquivos de dados.
Ele utiliza um formato de data para identificar as posies dos bytes no arquivo de dados
de origem que representam informaes sobre dia, ms e ano. O formato de data
criado automaticamente quando os dados so definidos por meio do Assistente de
definio de dados. O ACL apresenta sua avaliao do formato da data e permite
confirm-lo e modific-lo.
O formato da data no afeta a forma como as datas so exibidas no ACL. Para alterar a
forma como as datas so exibidas no ACL, consulte Opes de data na pgina 321 do
Guia do Usurio do ACL para Windows.
12
Manual de Referncia
A forma com a qual o ACL l os anos de dois dgitos depende da definio da preferncia do Incio do Sculo. Com a definio padro de 40, o ACL interpreta os anos 40
a 99 como 1940 a 1999, e os anos 00 a 39 como 2000 a 2039. O ACL utiliza esta definio
sempre que encontra dados que utilizam dois dgitos para representar o ano em um
arquivo de entrada. Isto no afetar os dados que utilizam trs ou quatro dgitos para
representar o ano.
Para alterar a configurao padro, consulte Incio do sculo na pgina 323 do
Guia do Usurio do ACL para Windows. Consulte Set (Definir) na pgina 303.
Datas seriais
As datas, s vezes, so representadas por um nmero serial. Os esquemas de datas seriais
representam a data como o nmero de dias decorridos a partir de alguma data inicial
arbitrria, como 1o de janeiro de 1900. Quando voc cria uma definio de arquivo de
entrada, o ACL reconhece o nmero serial como dado numrico.
As datas seriais no podem ser convertidas automaticamente para o tipo de campo de
data do ACL. Posteriormente necessrio utilizar as funes ACL para converter o
nmero serial em uma data, em um novo campo calculado. Consulte Datas em srie
na pgina 295 do Guia do Usurio do ACL para Windows.
Exemplo
preciso especificar o formato da data quando as datas estiverem armazenadas em
campos numricos comprimidos, tais como campos compactados.
1. Na barra de menus, selecione Editar e escolha definio de arquivo de entrada. O
ACL exibir a janela definio de arquivo de entrada.
2. Na guia [Editar campos/expresses], na exibio da lista de campos, d um clique
duplo no campo numrico compactado que voc deseja editar. O ACL exibe as
opes de formato de campo.
Captulo 1
Tipos de campo
Date (Data)
13
Atributos do campo
Designa o modificador
de campo de data
Parmetros
Por exemplo, se a data no arquivo de dados fonte tiver o formato AAMMDD, voc
selecionaria o mesmo formato na lista suspensa. Observe que os campos numricos no
podem conter pontuao no formato.
Formatos de data
Quando voc define o formato de um campo de data, informa ao ACL quais caracteres
representam o dia, o ms e o ano. O ACL utiliza os seguintes caracteres de formato para
representar os elementos de um campo de data:
Caracteres de formato
Elemento de data
DD
Dia (1 31)
DDD
MM
Ms (1 12)
MMM
AA
AAAA
14
Manual de Referncia
Coloque separadores, como um smbolo de barra (/), na mesma posio relativa que
estiverem no arquivo de dados de origem. Se voc no fizer isso, o ACL no interpretar
a data corretamente. O formato que voc define deve corresponder ao formato da data
armazenada. A tabela a seguir mostra diferentes maneiras de uma data ser armazenada
em um arquivo de entrada e como voc descreveria o formato para o ACL.
Data armazenada
991231
AAMMDD
12311999
MMDDAAAA
31DEZ1999
DDMMMAAAA
12/31/99
MM/DD/AA
99365
AADDD
Tipo
Exemplo utilizando
dezembro 31, 1999
AAAA-MM-DD
ISO
1999-12-31
Europeu
31/12/99
MM/DD/AA
Norte-americano
12/31/99
AADDD
Juliano
99365
Captulo 1
Tipos de campo
EBCDIC
15
exemplo, para descrever um campo com nmeros na forma de 991231 como uma data,
voc utilizaria o modificador de campo NDATE conforme mostrado abaixo:
DEFINE FIELD Campo_de_data NUMERIC 1 6 0 NDATE PIC "YYMMDD"
EBCDIC
L os dados codificados de acordo com o Extended Binary Coded Decimal Interchange
Code (EBCDIC).
Como o ASCII, o EBCDIC se refere a caracteres que podem ser impressos. Esse tipo de
campo a norma para todos os minicomputadores e mainframes da IBM. O comprimento mximo desse tipo de campo 32767 bytes.
Para obter mais informaes, consulte ASCII na pgina 8 para obter uma descrio
das outras formas principais de dados de caractere.
16
Manual de Referncia
De modo diferente de todos os outros tipos de campos que podem ser lidos pelo ACL, o
incio e o comprimento para esse tipo de campo so especificados em meio bytes, em
vez de bytes.
Por exemplo, para definir um campo halfbyte que se inicia no primeiro meio byte do
byte 3 e tem o comprimento de 10, voc deve clicar e arrastar para realar o campo na
janela Definio de arquivo de entrada, normalmente.
Em seguida, necessrio converter a posio inicial do campo em bytes (n) para meio
byte, usando a frmula (n*2)-1:
(3*2)-1=5
Logical (Lgico)
L dados em ASCII ou EBCDIC que tenham um valor lgico verdadeiro ou falso.
Logical refere-se a um campo com um byte de comprimento, que pode ser zero (falso)
ou no-zero (verdadeiro).
Nota: O ACL trata os dgitos (ASCII e EBCDIC) F (para Falso), 0 (para zero) ou N
(para No) (em maisculo ou minsculo) como falsos, apesar de, normalmente, avaliar o
valor diferente de zero como verdadeiro. Isso para poder usar os caracteres T e F, 0 e
1 ou Y e N como valores lgicos. O ACL tambm considera um branco ASCII (hex 20)
como falso, compatvel com produtos dBASE.
Captulo 1
Tipos de campo
Micro
17
Micro
L dados numricos binrios sem sinal criados em PCs e minicomputadores DEC.
Micro refere-se a um nmero binrio que armazena o byte menos significativo primeiro
e o mais significativo por ltimo. Esse tipo de campo no para campos binrios de
mainframe e de minicomputadores, que normalmente armazenam o byte mais significativo primeiro. Para obter mais informaes, consulte Binary (Binrio) na pgina 9.
O comprimento mximo do tipo de campo micro de 8 bytes. O nmero de decimais
o nmero implcito de dgitos decimais e no pode ser maior que o nmero de dgitos
implcitos no comprimento.
Os campos micro com comprimento par so tratados como campos binrios com sinal
(complemento de dois) e campos com comprimento mpar so tratados como campos
sem sinal (bytes de ordem superior zero implcitos so adicionados). Esse tipo de
campo apropriado para a representao de dados integer ou long de microcomputadores.
Numeric (Numrico)
L dados numricos ASCII ou EBCDIC que podem ser impressos e correspondem ao
tipo de campo display do COBOL.
Numeric refere-se a nmeros imprimveis em ASCII ou EBCDIC, em oposio aos
compactados ou zonados. Esse tipo de campo pode incluir qualquer pontuao, mas a
mais comum inclui espaos em branco iniciais ou finais, um sinal inicial ou final
opcional, pontos e uma vrgula decimal explcita. Numeric trata os zeros iniciais como
espaos em branco. Tem um comprimento mximo de 40 bytes (at 22 dgitos).
Nota: Casas decimais referem-se a dgitos decimais implcitos. Se uma definio de campo
incluir decimais sem nenhuma vrgula decimal explcita, uma vrgula decimal ser
implcita. Por exemplo, em um campo com duas casas decimais, o ACL interpretar 123
como 1,23; 12,3 como 12,30 e 12, como 12,00.
Se as casas decimais especificadas diferirem dos decimais explcitos no campo, este ser
arredondado para o nmero de decimais apropriado.
O ACL interpretar corretamente parnteses e CR como negativo, mas ignorar
vrgulas e outras pontuaes (como $). Os sinais podem ser iniciais ou finais, fixos ou
flutuantes.
18
Manual de Referncia
Packed (Compactado)
L o tipo de campo numrico compactado gerado por mainframes.
Packed refere-se ao tipo de campo numrico compactado de mainframe que armazena
dois dgitos numricos por byte. O byte mais direita contm uma indicao de sinal na
metade inferior do byte (normalmente HEX C para positivo e HEX D para negativo).
A metade superior do byte extremo direito e cada metade de todos os outros bytes
contm um dgito hexadecimal representando o dgito decimal daquela posio no
nmero.
O comprimento mximo desse tipo de campo de 12 bytes (23 dgitos), entretanto, o
ACL gera uma mensagem de erro se encontra um nmero maior que 22 dgitos. Conseqentemente, quando voc definir um campo numrico compactado na janela
Definio de arquivo de entrada, o nmero de decimais que voc especifica na caixa de
texto Formato no deve resultar em um nmero maior que 22 dgitos. Por exemplo, se
os seus dados contiverem nmeros de sete dgitos, voc no poder especificar mais de
15 casas decimais (22 dgitos 7 dgitos).
O tipo de campo numrico compactado corresponde aos tipos de dados fixed decimal
do PL/1 e computational-3 do COBOL.
Nota: Embora a especificao da IBM para esse tipo de campo indique que os sinais dos
hex B e D representam valores negativos, quase todos os softwares usam apenas o D
para negativos. Assim sendo, o ACL trata B como positivo para ser compatvel com alguns
hardwares que no sejam da IBM. Se isto causar um problema no seu ambiente, entre em
contato com o Suporte Tcnico para obter assistncia.
Para obter mais informaes sobre os dados compactados Unisys, consulte Unisys na
pgina 21.
Captulo 1
Tipos de campo
Packed (Compactado)
19
20
Manual de Referncia
PCASCII
L dados codificados de acordo com o ASCII (American Standard Code for Information Interchange).
O tipo de campo PCASCII quase o mesmo tipo de campo ASCII. Voc pode us-lo
quando os dados em um arquivo forem criados em um aplicativo DOS, ou quando o
arquivo incluir caracteres de idioma estrangeiro. O tipo de campo PCASCII assegura
que os caracteres de idioma estrangeiro sejam corretamente interpretados.
O formato do tipo de campo idntico ao formato do tipo de campo ASCII.
Print (Imprimir)
L dados numricos ASCII ou EBCDIC imprimveis.
Esse campo exatamente igual ao numeric, exceto pelo seu tratamento de campos com
nenhuma vrgula decimal explcita. Se uma definio de campo incluir casas decimais,
mas nenhuma vrgula decimal explcita, Print assumir que no existem decimais para
o registro.
Captulo 1
Tipos de campo
Unisys
21
Por exemplo, em um campo com duas casas decimais, 123 interpretado como 123,00;
12,3 como 12,30 e 12, como 12,00.
O comprimento mximo desse tipo de campo de 40 bytes, entretanto, o ACL gera uma
mensagem de erro se um nmero maior que 22 dgitos for encontrado.
O tipo de campo Print corresponde ao tipo de campo display do COBOL, completo com
pontos, sinal e vrgula. Print no apenas ignora os pontos, mas interpreta corretamente
parnteses e CR como negativo. Os sinais podem ser iniciais ou finais, fixos ou flutuantes e qualquer outra pontuao (como $) ignorada.
Unisys
L dados compactados da Unisys/Burroughs alinhados por byte.
Campos packed da Unisys/Burroughs, de maneira diferente que os campos IBM
compactados, tm o sinal do lado esquerdo em vez do direito. O tipo de campo Unisys
se refere ao tipo de campo packed do mainframe da Unisys/Burroughs que armazena
dois dgitos decimais por byte. Esse tipo de campo no pode ser impresso.
O byte mais esquerda do campo contm uma indicao de sinal na metade superior do
byte, que normalmente hexadecimal C ou F para positivo e hexadecimal D para
negativo. Cada metade de todos os outros bytes contm um dgito hex que o valor do
nmero nessa posio.
O comprimento mximo desse tipo de campo de 12 bytes, mas o ACL ir gerar uma
mensagem de erro se um nmero maior que 22 dgitos for encontrado. O nmero de
decimais o nmero de dgitos decimais implcito e no pode exceder o nmero de
dgitos implicado pelo comprimento.
Dados Unisys compactados sem sinal devem ser especificados como unsigned, porque
seu formato o mesmo formato da IBM.
Nota: Computadores da Unisys podem trabalhar com dados alinhados em meio byte e
dados com comprimento de meio byte, mas o tipo de campo Unisys incompatvel com eles.
Para ler esses dados, use o tipo de campo halfbyte como descrito em Halfbyte (Meio byte)
na pgina 15.
22
Manual de Referncia
VAXfloat
L dados de ponto flutuante DEC VAX tipo D, que a mais comum das quatro representaes de ponto flutuante do VAX.
O comprimento desse tipo de campo de 4 ou 8 bytes.
Zoned (Zonado)
L dados numricos ASCII ou EBCDIC do tipo de campo decimal zonado (IBM) ou
PIC S9(n) (COBOL). Em outras palavras, l quaisquer dados zonados, incluindo os
gerados pelas mquinas DEC, Honeywell e IBM.
ZONED se refere aos campos numricos zoned de mainframe, um dgito por byte,
codificados em ASCII ou EBCDIC. Os zeros iniciais devem ser retidos. A metade
superior do byte extremo direito do campo inclui o sinal negativo. O comprimento
mximo de um campo zoned de 22 bytes.
O tipo de campo decimal zonado da IBM e o tipo de campo PIC S9(n) do COBOL so
comumente exibidos como um nmero de dgitos seguidos por uma letra indicando o
sinal.
O tipo de campo zoned compatvel com os tipos de campo DEC DIBOL, no qual uma
letra minscula entre p e y indica valores negativos. O ACL detecta automaticamente e ajusta para campos zoned de acordo com os formatos IBM, Honeywell e DEC.
Captulo 2
F UNES
BIT( )
BYTE( )
CHR( )
DIGIT( )
HEXADECIMAL( )
MASK( )
SHIFT( )
Funes de converso
DECIMALS( )
EBCDIC( )
PACKED( )
STRING( )
23
24
Manual de Referncia
UNSIGNED( )
VALUE( )
ZONED( )
Retorna o perodo (em dias) de uma data comparada a uma data limite
especfica ou com a data do sistema atual.
CDOW( )
CTOD( )
DATE( )
DOW( )
TIME( )
Funes lgicas
BETWEEN( )
FIND( )
ISBLANK( )
MAP( )
MATCH( )
SOUNDSLIKE( )
TEST( )
VERIFY( )
Captulo 2
Funes
Resumo das funes
Funes matemtica
ABSOLUTE( )
EXPONENT( )
FREQUENCY( )
INTEGER( )
LOGARITHM( )
MAXIMUM( )
MINIMUM( )
MOD( )
RANDOM( )
ROOT( )
ROUND( )
ZSTAT( )
Funes financeiro
EFFECTIVE( )
FVANNUITY( )
FVLUMPSUM( )
NOMINAL( )
NPER( )
PMT( )
PVANNUITY( )
PVLUMPSUM( )
RATE( )
25
26
Manual de Referncia
Funes diversas
FILESIZE( )
FTYPE( )
LEADING( )
OFFSET( )
RECLEN( )
RECNO( )
AT( )
BLANKS( )
CLEAN( )
EXCLUDE( )
INCLUDE( )
INSERT( )
LAST( )
LENGTH( )
LOWER( )
Captulo 2
Funes
Resumo das funes
LTRIM( )
OCCURS( )
PROPER( )
REMOVE( )
REPEAT( )
REPLACE( )
REVERSE( )
RJUSTIFY( )
SOUNDEX( )
SPLIT( )
SUBSTRING( )
TRANSFORM( )
TRIM( )
UPPER( )
27
28
Manual de Referncia
ABSOLUTE( )
ABS( ) retorna o valor absoluto de uma expresso numrica.
Use ABS( ) para determinar o valor absoluto de uma populao, antes de gerar uma
amostra aleatria.
Formato da funo
ABS(N)
Exemplos
ABS(-7,2) = 7,2
ABS(88,2)= 88,2
ABS(5)= 5
Para criar um campo que seja a diferena entre dois campos (AMT1 e AMT2), especifique:
ABS(AMT1 - AMT2)
AGE( )
AGE( ) retorna o perodo, em dias, de uma data especificada, comparada com uma data
limite especificada.
Use AGE( ) ao comparar duas datas, a fim de determinar contas vencidas ou executar
anlises de vencimento de saldos.
Formato da funo
AGE(C|D <;C|D>)
Captulo 2
Funes
ALLTRIM( )
29
As datas anteriores data limite retornam com um valor positivo. As datas posteriores
data limite retornam com um valor negativo.
As datas aceitveis esto no intervalo de 1 de janeiro de 1900 at 31 de dezembro de
9999.
Exemplos
Supondo-se que a data atual do sistema seja 1 de janeiro de 1996:
AGE(`951220`) = 12
AGE(`19960108`) = -7
AGE(`19941220`;`950101`) = 12
AGE(Datefld) = 65
AGE(DueDate;`961231`) = 80
Para extrair o nome, valor e data da fatura de todos os itens vencidos h mais de 180 dias
(at o final do ano fiscal), especifique:
AGE(DATE;`961231`)>180
ALLTRIM( )
ALLTRIM( ) retorna uma cadeia de comprimento varivel, com os espaos em branco
no incio e no fim removidos. Os espaos em branco dentro da cadeia de caracteres no
so removidos.
ALLTRIM( ) similar a LTRIM( ), que remove os espaos em branco no incio e a
TRIM( ), que remove os espaos em branco no fim da cadeia de caracteres.
Formato da funo
ALLTRIM(C)
Exemplos
ALLTRIM("
ALLTRIM("
abc
a bc
") = "abc"
") = "a bc"
ASCII( )
ASCII( ) retorna o valor decimal ASCII do primeiro caractere de uma expresso com
caracteres especificada ou campo de caracteres. Essa funo o inverso da funo
CHR( ).
Use ASCII( ) para verificar os valores do campo de caracteres quando os caracteres no
puderem ser impressos, como tabulaes.
30
Manual de Referncia
Formato da funo
ASCII(C)
Exemplos
ASCII("A") = 65
ASCII("1") = 49
AT( )
AT( ) retorna a posio de uma cadeia de caracteres dentro de outra cadeia de caracteres. necessrio especificar que ocorrncia da cadeia deve ser pesquisada. Se no for
localizada a cadeia, ser retornado um valor zero.
Para a maioria das aplicaes, que desejam apenas saber se uma cadeia est presente, a
funo FIND( ) a alternativa mais fcil. AT( ) ainda requerida se for necessria a
localizao da cadeia ou se voc estiver pesquisando vrias ocorrncias.
Use AT( ) para procurar um valor especfico em um campo de texto livre (como uma
descrio, nome ou endereo).
Formato da funo
AT(N;C1;C2)
AT( ) pesquisa cadeias dentro de outras cadeias e possui trs argumentos: N, C1 e C2.
N especifica qual ocorrncia da cadeia C1 deve ser pesquisada.
C1 especifica a cadeia de caracteres que deve ser pesquisada.
C2 especifica a cadeia de caracteres a ser pesquisada.
O valor retornado uma localizao dentro da cadeia pesquisada, C2. AT( ) pode ser
interpretada como em qual posio est a N-sima ocorrncia da cadeia C1 na cadeia
C2?.
Captulo 2
Funes
AT( )
31
Exemplos
AT(1;
AT(2;
AT(2;
AT(3;
"ABC"; "ABCDEFG")= 1
"ABC"; "ABCDEFGABCDEFG")= 8
"A"; "ABCDEFGH")= 0
"ABC"; "ABCDEFGABCDEFG")= 0
Para extrair todos os registros nos quais o endereo Wild Street, especifique:
AT(1;"WILD";UPPER(ADDRESS))>0
Extrair registros
Condio
Nome do arquivo extrado
A funo UPPER( ) utilizada para que a pesquisa no faa distino entre maisculas
e minsculas. Se a expresso AT( ) retornar um valor maior que zero, Wild foi encontrado no campo Address e o registro ser extrado.
Nota: Este teste tambm localizar Wilder St. e Swilden Ave. Para ser mais especfico,
voc poder incluir um espao em branco, antes e depois de WILD.
32
Manual de Referncia
Para contar o nmero de registros de um arquivo nos quais o nome Doe, especifique:
AT(1; "DOE";NAME)>0
BETWEEN( )
BETWEEN( ) retorna Verdadeiro ou Falso, dependendo se um valor especificado
estiver entre um valor mnimo ou mximo, incluindo estes dois valores.
Use BETWEEN( ) para testar intervalos de valores, tal como testar se uma quantidade se
encontra entre 20.000 e 60.000, incluindo. Tambm possvel us-lo para testar intervalos de datas ou de caracteres alfabticos.
Formato da funo
BETWEEN(valor;mnimo;mximo)
ou
BETWEEN(valor;mximo;mnimo)
Captulo 2
Funes
BIT( )
33
Os formatos de data podem diferir para os trs parmetros, uma vez que o ACL avalia a
data independentemente de como est armazenada em um arquivo de dados ou
apresentada em uma visualizao.
As comparaes de caracteres distinguem maisculas e minsculas. A ordem de classificao dos caracteres depende do idioma selecionado na guia [Opes do arquivo de
entrada] da caixa de dilogo Editar preferncias do ACL. As opo Comparaes exatas
de caractere do ACL rege a forma como o ACL compara as cadeias de caracteres. Se a
opo Set Exact estiver desativada, A considerado igual a ABC e ABXYZ. Se a
opo Set Exact estiver ativada, A no considerado igual a ABC. A configurao
padro para esta opo OFF.
Para obter mais informaes consulte Comparaes exatas de caractere na pgina 315
do Guia do Usurio do ACL para Windows.
Exemplos
BETWEEN(5;4;7) = T
BETWEEN(5;5;7) = T
BETWEEN(5;6;7) = F
BETWEEN("abc";"A";"B") = F (Observao: retornado um valor
Falso, porque a comparao distingue entre maisculas e
minsculas)
BETWEEN("ABC";"A";"B") = T
BETWEEN("BCD";"ABC";"BB") = F
BETWEEN(`20011131`;`20011031`;`20011131`) = T
BIT( )
BIT( ) retorna a cadeia de bits, representando uma posio de byte especificada no
registro atual. Use BIT( ) para examinar os bits individuais em um byte. BIT( ) opera de
modo semelhante funo BYTE( ) na pgina 35.
Formato da funo
BIT(N)
BIT( ) converte o byte na localizao N do registro atual em uma cadeia com oito caracteres de comprimento, de 0s e 1s, que representa o byte.
34
Manual de Referncia
Exemplos
Para atribuir os valores de bit para os bytes 8, 9 e 17 para as variveis b8, b9 e b17, especifique:
ASSIGN b8= BIT(8)
ASSIGN b9= BIT(9)
ASSIGN b17= BIT(17)
Voc encontrar:
Condio
Nome de arquivo extrado
Captulo 2
Funes
BLANKS( )
35
BLANKS( )
BLANKS( ) cria uma cadeia de caracteres de comprimento especificado, consistindo
exclusivamente de espaos em branco.
Use BLANKS( ) para formatar um campo com espaos em branco, a fim de inicializar
uma varivel ou tornar um campo maior, por meio da adio de um nmero fixo de
espaos em branco.
Formato da funo
BLANKS(#)
Exemplos
BLANKS(5) = "
BLANKS(10) = "
"
"
"
BYTE( )
BYTE( ) retorna a interpretao do caractere ASCII de um byte, em uma posio
especificada no registro atual.
Use BYTE( ) para examinar o contedo de uma posio em um registro, sem precisar
definir um campo para este propsito. Se voc usar essa funo em dados EBCDIC, o
valor retornado tambm ser em EBCDIC. Voc pode ter problemas ao comparar esses
dados com os valores de caracteres.
Formato de funo
BYTE(N)
36
Manual de Referncia
Exemplos
Dado um registro contendo:
10072DOE
JOHN
123188
....|....1....|....2....|....3....|....4....|
BYTE(4)= 7
BYTE(25)= H
BYTE(30)=
CDOW( )
CDOW( ) retorna o nome do dia da semana para uma data especificada.
Para exibir o dia da semana como nmero, use a funo DOW( ).
Formato de funo
CDOW(D;#)
D especifica a data.
# especifica o comprimento do campo. Para exibir nomes abreviados, especifique um
Exemplos
Para exibir o nome do dia da semana:
CDOW(`20000801`;11) = "Tera-feira"
CDOW(`20000802`;12) = "Quarta-feira"
CDOW(`20000801`;3) = "Ter"
CHR( )
CHR( ) retorna o caractere ASCII correspondente ao valor decimal especificado.
Permite consultar qualquer caractere ASCII, especialmente os que no podem ser
inseridos diretamente pelo teclado ou que no podem ser impressos.
CHR( ) o inverso da funo ASCII( ).
Captulo 2
Funes
CLEAN( )
37
Formato da funo
CHR(N)
Exemplos
possvel usar CHR( ) para adicionar o smbolo monetrio libra esterlina (caractere
ASCII 163) em um campo com valores monetrios, para fins de formatao:
CHR(163)+"123,45"= "123,45"
possvel tambm, utilizar CHR( ) como parte de um teste para pesquisar a existncia
de um caractere especfico no-imprimvel em campos ou registros.
CLEAN( )
CLEAN( ) procura quaisquer caracteres invlidos em uma cadeia e os substitui, bem
como a todos os caracteres subseqentes, por espaos em branco.
Use CLEAN( ) para assegurar-se de que todos os campos contendo dados invlidos
sejam impressos corretamente. Voc tambm poder usar CLEAN( ) para isolar partes
de um campo, como o sobrenome em um campo de cliente, que inclua o nome e o
sobrenome do cliente.
Formato da funo
CLEAN(C1 <;C2>)
38
Manual de Referncia
Exemplos
CLEAN("ABC%DEF";"%")= "ABC "
CLEAN("1234,56,111,2";",") = "1234,56 "
"
"
CTOD( )
CTOD( ) converte um caractere ou expresso numrica em uma expresso de data
vlida.
Use CTOD( ) para criar uma data para fins de comparao com valores de campo de
data, especialmente se ela no for uma constante. Por exemplo, para identificar todas as
datas antes de uma determinada data, voc pode usar o teste:
DATE<CTOD(ano+ms+dia)
Nota: O ACL usar uma data inicial de 1 de janeiro de 1900 para determinar o valor de
data apropriado.
Esse procedimento tem sido substitudo pelo uso de constantes de data. Para obter mais
informaes, consulte Datas na pgina 293 do Guia do Usurio do
ACL para Windows.
Formato da funo
CTOD(C|N <;C>)
A funo CTOD( ) (abreviao de Caractere para Data) converte a cadeia de caracteres ou valores numricos em datas vlidas. CTOD( ) o nome da funo padro para
muitos outros softwares. Diferente de outros pacotes de software, o ACL tambm
converte expresses numricas em datas.
Se o primeiro parmetro for um nmero, ele automaticamente convertido em uma
cadeia, antes da converso.
Captulo 2
Funes
DATE( )
39
Nota: A cadeia de formatao tem a mesma forma que Definir data e o tipo de campo de
data. Pode ser includa pontuao na cadeia a ser convertida. Como a cadeia de formatao , na realidade, uma cadeia de caracteres, ao invs de uma data, ela deve ser
delimitada por aspas duplas ou simples (e no por aspas invertidas).
Exemplos
Suponha que voc possua um arquivo de transaes de contas a receber que inclua um
campo de data de vencimento denominado Vencimento. Voc deseja exibir todas as
transaes que tenham uma data de vencimento anterior a 1 de julho de 1995. Para isso,
precisar comparar o campo Vencimento ao valor 1 de julho de 1995. Como o campo
Vencimento interpretado pelo ACL como um nmero nico, voc no poder
compar-lo a 01/07/95 ou a 950701. Dever converter 1 de julho de 1995 em outro
nmero.
Para isso, use um teste If ou um filtro, como a seguir:
Vencimento<CTOD(950701)
DATE( )
DATE( ) converte uma expresso de data, a data atual do sistema ou um valor de campo
de data em uma representao de cadeia de caracteres.
Use DATE( ) quando precisar exibir a data atual como um cadeia.
40
Manual de Referncia
Formato da funo
DATE(<D>)
Se nenhum parmetro for fornecido, a data do sistema ser convertida. Caso contrrio,
a data fornecida D ser convertida.
A data retornada como uma cadeia de caracteres de 12 bytes, no formato especificado
por Set Date. Se Set Date especificar um formato mais curto que 12 bytes, o valor
retornado ser preenchido com espaos em branco. Para obter mais informaes sobre
o comando Definir Data, consulte Set (Definir) na pgina 303.
Exemplos
Usando as configuraes de data padro DD/MM/AA, uma data de sistema 22 de
novembro de 1995 e um valor de campo de data 31 de dezembro de 1995:
DATE( ) = "22/11/95 "
DATE(DATEFLD)= "31/12/95 "
DECIMALS( )
DEC( ) permite especificar o nmero de casas decimais para uma expresso numrica
ou valor de campo. Use DEC( ) quando desejar ajustar casas decimais em clculos
matemticos ou quando desejar arredondar um resultado para um determinado
nmero de casas decimais.
Formato da funo
DEC(N;#)
Onde # uma constante numrica representando casas decimais que no podem ser
alteradas de registro para registro.
DEC( ) toma o valor de uma expresso numrica N e ajusta o nmero de decimais
especificado quele especificado por #. Se o nmero de decimais estiver sendo reduzido,
o ACL arredondar o resultado.
No possvel usar a funo DEC( ) aps um clculo, a fim de reverter o arredondamento. Por exemplo, DEC(3/2;4) = 1,0000, no 1,5000.
Nota: O nmero de decimais uma constante e no possvel alter-lo durante o processo.
Exemplos
DEC(7;2) = 7,00
DEC(7,5647;3)= 7,565
Captulo 2
Funes
DIGIT( )
41
Para criar um campo de taxa de juros diria (com seis casas decimais), a partir de um
campo de taxa de juros anual, especifique:
DEC(ANNUAL_RATE;6)/365
DIGIT( )
DIGIT( ) retorna o valor superior ou inferior de um byte compactado, em uma posio
especificada no registro.
Use DIGIT( ) quando necessitar de acesso a metades individuais de bytes em aplicaes
como Unisys e NCR, as quais utilizam campos compactados alinhados em meio byte.
Formato da funo
DIGIT(N;1|2)
Exemplos
Um campo compactado com o valor 123,45 (00 12 34 5C), contendo dois decimais e
iniciando na posio 10 de byte, aparece no registro de dados no seguinte formato:
UPPER (1)
Byte 10
Byte 11
Byte 12
Byte 13
42
LOWER (2)
Manual de Referncia
Byte 10
Byte 11
Byte 12
Byte 13
Para identificar que dgito aparece na 12 posio na metade superior do byte use:
DIGIT(12;1) = 3
Para identificar que dgito aparece na 12 posio na metade inferior do byte, use:
DIGIT(12;2) = 4
Para obter mais informaes sobre como trabalhar com dados UNISYS, consulte
Unisys na pgina 21.
DOW( )
DOW( ) retorna uma cadeia de caracteres contendo um dgito de 1 a 7, representando o
dia da semana. O dgito 1 representa o Domingo.
Para exibir o nome do dia da semana, use a funo CDOW( ).
Formato da funo
DOW(D)
Exemplo
Para exibir o dia da semana como um nmero de um nico dgito:
DOW(`19991124`) = 4
EBCDIC( )
Converte uma cadeia em caracteres EBCDIC.
Use EBCDIC( ) para converter dados de exportao para aplicativos ou plataformas
no-baseadas em ASCII, como OS/390 ou AS400.
Formato da funo
EBCDIC(C)
Captulo 2
Funes
EFFECTIVE( )
43
Exemplo
Para criar um campo que contenha o valor EBCDIC do campo de nome, a fim de
carreg-lo em um mainframe, especifique:
EBCDIC(NAME)
EFFECTIVE( )
EFFECTIVE( ) calcula a taxa de juros anual efetiva sobre um emprstimo.
Use EFFECTIVE( ) para determinar a taxa de juros anual efetiva quando voc conhece
a taxa de juros declarada e o nmero de perodos compostos. Por exemplo, se voc sabe
que a taxa de juros cobrada por seu carto de crdito composta mensalmente, mas
quer saber qual a taxa anual equivalente, considerando os juros compostos, voc pode
usar essa funo. Para obter mais informaes, consulte Funes financeiras na
pgina 286 do Guia do Usurio do ACL para Windows.
Formato de funo
EFFECTIVE(taxa_nominal; perodos)
taxa_nominal a taxa de juros anual nominal.
perodos o nmero de perodos compostos por ano. perodos truncado em um
nmero inteiro.
Exemplo
Se voc sabe que seu carto de crdito cobra a taxa de 18%, composta mensalmente
sobre os saldos vencidos, para calcular a taxa anual efetiva, especifique:
EFFECTIVE(.18;12) = 0,19561817
44
Manual de Referncia
EXCLUDE( )
EXCLUDE( ) retorna um cadeia de comprimento varivel, excluindo os caracteres
especificados a partir do resultado.
EXCLUDE( ) o oposto da funo INCLUDE( ).
Formato da funo
EXCLUDE(C1;C2)
Exemplos
EXCLUDE("123 any street";"0123456789")=" any street"
Para remover uma vrgula, uma barra e um sinal numrico do campo PRODNO, especifique:
EXCLUDE(Prodno;",/#")
EXPONENT( )
EXP( ) retorna o valor exponencial (base 10) de uma expresso numrica.
Use EXP( ) para aplicaes financeiras que necessitam de clculos matemticos
complexos. EXP( ) realiza uma operao semelhante do operador de potenciao ^,
mas pode ser til em aplicaes que tambm usam a funo LOG( ).
EXP( ) o oposto da funo LOG( ).
Formato da funo
EXPONENT(N;#)
Onde # uma constante numrica representando casas decimais que no podem ser
alteradas, de registro para registro.
EXP( ) retorna o valor exponencial (base 10) da expresso numrica ou valor de campo
N com # casas decimais. O valor exponencial de um nmero definido como 10 elevado
N-sima potncia. Portanto, o valor exponencial de 3 1000. O inverso de um
expoente seu logaritmo.
Exemplos
EXP(3;2) = 1000,00
EXP(4,86;6)= 72443,596007
Captulo 2
Funes
FILESIZE( )
45
Para criar um campo que seja a raiz cbica do campo X com duas casas decimais,
especifique:
EXP(LOG(X;6)/3;2)
FILESIZE( )
FILESIZE( ) retorna o tamanho de um arquivo.
Use FILESIZE( ) para especificar o tamanho de um arquivo em bytes ou determinar se
o arquivo existe. A funo FILESIZE( ) retorna o tamanho de um arquivo em bytes ou
1, se o arquivo no existir.
Normalmente, essa funo usada para verificar a existncia de um arquivo de forma a
controlar a execuo de um batch, ou usar o tamanho retornado para algum clculo til.
Formato da funo
FILESIZE(nome-do-arquivo)
Nome-do-arquivo o nome do arquivo cujo tamanho voc deseja determinar. Se o
arquivo estiver no mesmo diretrio que o Projeto ACL, no ser necessrio especificar
todo o caminho. Para arquivos contidos em outros diretrios, digite um caminho
relativo, como dados\nome-do-arquivo.fil, ou um caminho absoluto, como
c:\acl\dados\nome-do-arquivo.fil.
Exemplos
Para executar o batch TEST somente se o arquivo Demo.fil existir:
DO TEST IF FILESIZE("Demo.fil")>0
46
Manual de Referncia
FIND( )
possvel usar FIND( ) para verificar a presena de uma cadeia de caracteres em um
campo ou registro. A funo FIND( ) no distingue entre maisculos e minsculos
(localiza maisculos e minsculos), bem como caracteres ASCII e EBCDIC. FIND( )
retorna Verdadeiro se a cadeia for localizada seno, retorna Falso.
Formato da funo
FIND(C;<campo>)
FIND( ) pesquisa a cadeia C no campo especificado por campo. Se campo for omitido,
FIND( ) pesquisar a cadeia C em todo o registro.
Exemplos
FIND("New York";CITY)
FIND("New York")
Captulo 2
Funes
FREQUENCY( )
47
Funo FIND
Se voc acha que poder usar esse filtro novamente, digite um nome na caixa de
texto Salvar como a fim salvar o filtro para uso posterior.
3. Clique em [OK]. Como a funo retorna Verdadeiro se a cadeia for localizada e Falso
caso contrrio; o ACL filtra os registros que no contiverem New York.
FREQUENCY( )
FREQUENCY( ) retorna a freqncia de Benford esperada para dgitos numricos
positivos iniciais seqenciais com uma preciso de oito dgitos. Ela permite a execuo
de testes de Benford limitados para situaes especficas.
Use FREQUENCY( ) no lugar de uma anlise de Benford completa quando desejar
concentrar-se apenas em combinaes de dgitos especficas. Por exemplo, ao auditar
pedidos de indenizao de seguro que tenham limites de aprovao com valores especificados, possvel usar a funo FREQUENCY( ) para investigar valores imediatamente
inferiores ao limite de aprovao. Para investigar pedidos com valor prximo a um
48
Manual de Referncia
Formato da funo
FREQUENCY(C)
C uma cadeia de caracteres consistente apenas dos dgitos de 0 a 9 e tem um valor
equivalente maior que zero. FREQUENCY( ) ignora quaisquer zeros esquerda na
cadeia de caracteres.
Nota: A especificao de cadeias maiores que seis dgitos pode resultar em valores zero. Os
clculos para cadeias maiores que seis dgitos podem exigir preciso maior que o limite do
ACL de oito casas decimais.
Exemplos
FREQUENCY("43") =0,00998422
FREQUENCY("87654321") = 0,00000000
FTYPE( )
FTYPE( ) retorna um valor para identificar um tipo de campo ou outro item.
Use FTYPE( ) para verificar tipos de campo ao executar um batch.
Formato da funo
FTYPE(C)
Se C for o nome do campo atual, o valor retornado ser C, N, L ou D maisculos, indicando que o campo do tipo caractere, numrico, lgico ou data, respectivamente.
Se C for um nome de varivel, o valor retornado ser c, n, l ou d minsculos,
indicando que o campo do tipo caractere, numrico, lgico ou data, respectivamente.
Captulo 2
Funes
FVANNUITY( )
49
Exemplos
Se Letter representa um campo de caractere e Number representa um campo
numrico:
FTYPE("LETTER") = "C"
FTYPE("NUMBER") = "N"
Se voc tiver um aplicativo padro que faa uso do campo Amount para fins de totalizao, dever certificar-se de que existe realmente um campo Amount e que seja
numrico, antes de iniciar a aplicao padro.
O batch a seguir ser executado apenas se Amount for um campo numrico:
DO STDAPP IF FTYPE("AMOUNT") = "N"
FVANNUITY( )
FVANNUITY( ) calcula o valor futuro de uma srie de pagamentos.
Use FVANNUITY( ) quando quiser determinar quanto uma anualidade acumular em
determinado perodo. O valor futuro de uma srie de pagamentos o montante total
que a srie acumular, acrescido dos juros compostos. Por exemplo, ao depositar o
mesmo montante todos os meses em sua conta bancria, o saldo final seu valor futuro,
ou seja, a soma dos depsitos acrescida dos juros compostos acumulados. Para obter
50
Manual de Referncia
Formato da funo
FVANNUITY(taxa;perodos;valor)
taxa a taxa de juros para o perodo.
perodos o nmero total de perodos de pagamento em uma anualidade.
valor o pagamento efetuado ao final de cada perodo. Esse valor no pode mudar
durante a anualidade.
Exemplos
Para calcular o valor futuro que seria acumulado se voc depositasse R$ 1.000 por ms
durante um ano, com um rendimento mensal de 1%, especifique:
FVANNUITY(,01;12;1000) = 12.682,50
Para calcular o montante que voc acumularia se depositasse R$ 2.000 por ms durante
trs anos, com um rendimento anual de 7% composto mensalmente, especifique:
FVA(,07/12;36;2000) = 79.860,20
FVLUMPSUM( )
FVLUMPSUM( ) calcula o valor futuro de uma soma global, aps determinado nmero
de perodos.
Use FVLUMPSUM( ) para determinar o valor futuro de um investimento. O valor
futuro o montante total que ser acumulado, com juros compostos. Por exemplo,
quando voc deposita uma soma global em sua conta bancria e no a movimenta, o
saldo final o valor futuro. Para obter mais
52
Manual de Referncia
Exemplos
Para localizar o valor hexadecimal do campo X que contm a cadeia 12345:
HEX(X) = "3132333435"
Para adicionar exibio um campo que seja o valor hexadecimal do campo Count,
especifique:
HEX(COUNT)
INCLUDE( )
INCLUDE( ) retorna uma cadeia de comprimento varivel, incluindo no resultado
apenas os caracteres especificados.
INCLUDE( ) o oposto da funo EXCLUDE( ).
Formato da funo
INCLUDE(C1;C2)
Exemplos
INCLUDE("123 qualquer rua";"0123456789")="123"
Para criar um campo Prod que contenha apenas os dgitos do campo Prodno,
especifique:
INCLUDE(Prodno;"123456789")
INSERT( )
INSERT( ) insere caracteres ou espaos em branco em uma cadeia de caracteres, em
qualquer posio.
Use INSERT( ) a fim de normalizar dados para formatao, para correspondncia de
duplicidades e para os comandos Associar e Relacionamentos, que exigem campos
idnticos.
Por exemplo, os nmeros de pea em um arquivo podem estar em um formato 12345
e em outro arquivo, 12-345. possvel usar INSERT( ) para inserir um hfen (-) na
posio 3.
52
Manual de Referncia
Exemplos
Para localizar o valor hexadecimal do campo X que contm a cadeia 12345:
HEX(X) = "3132333435"
Para adicionar exibio um campo que seja o valor hexadecimal do campo Count,
especifique:
HEX(COUNT)
INCLUDE( )
INCLUDE( ) retorna uma cadeia de comprimento varivel, incluindo no resultado
apenas os caracteres especificados.
INCLUDE( ) o oposto da funo EXCLUDE( ).
Formato da funo
INCLUDE(C1;C2)
Exemplos
INCLUDE("123 qualquer rua";"0123456789")="123"
Para criar um campo Prod que contenha apenas os dgitos do campo Prodno,
especifique:
INCLUDE(Prodno;"123456789")
INSERT( )
INSERT( ) insere caracteres ou espaos em branco em uma cadeia de caracteres, em
qualquer posio.
Use INSERT( ) a fim de normalizar dados para formatao, para correspondncia de
duplicidades e para os comandos Associar e Relacionamentos, que exigem campos
idnticos.
Por exemplo, os nmeros de pea em um arquivo podem estar em um formato 12345
e em outro arquivo, 12-345. possvel usar INSERT( ) para inserir um hfen (-) na
posio 3.
Captulo 2
Funes
INTEGER( )
53
Formato da funo
INSERT(C1;C2;N)
INSERT( ) retorna uma cadeia onde a cadeia C2 inserida na cadeia C1, na posio N. Se
N for maior que o comprimento da cadeia C1, a cadeiaC2 colocada no final da cadeia
C1. Se N for menor ou igual a 1, a cadeia C2 colocada na frente da cadeia C1.
Exemplos
INSERT("abcde";"XXX";2) = "aXXXbcde"
INSERT("abcde";"XXX";8) = "abcdeXXX"
INSERT("abcde";"XXX";0) = "XXXabcde"
INTEGER( )
INT( ) retorna o valor inteiro de uma expresso numrica ou valor de campo.
Use INT( ) para ignorar ou isolar a parte fracionria de uma expresso.
Formato da funo
INTEGER(N)
Exemplos
INT(7,9)= 7
INT(-7,9)= -7
Para criar o campo Cents, que a poro do campo Amount em que voc est
interessado, especifique:
Amount - INT(Amount)
ISBLANK( )
ISBLANK( ) retorna Verdadeiro ou Falso, dependendo se uma cadeia consiste inteiramente de espaos em branco.
54
Manual de Referncia
Use ISBLANK( ) para localizar registros com ausncia de informaes. Esta funo
pesquisa entradas em branco em campos que no deveriam cont-las e foi prevista para
testes lgicos.
Formato da funo
ISBLANK(C)
Exemplos
ISBLANK(" A") = F
ISBLANK(" ") = T
ISBLANK("") = T
LAST( )
LAST( ) retorna um nmero especificado de caracteres a partir do final de uma cadeia.
Formato da funo
LAST(C;#)
Exemplos
LAST("abcdefghi";5) = "efghi"
LAST("abcdefghi ";5) = "ghi "
LAST("abc";6) = "
abc"
Captulo 2
Funes
LEADING( )
55
LEADING( )
LEADING( ) retorna uma cadeia de caracteres contendo um nmero especificado de
dgitos iniciais.
Use LEADING( ) para filtrar elementos que no sejam dgitos significativos, como zeros
esquerda, dgitos no-numricos e pontuao como sinais decimais ou cifro.
Formato da funo
LEADING(N;#)
# deve ser um nmero inteiro positivo, maior que 0.
Exemplos
Se um campo numrico chamado Amount contiver o valor $-6.234,56, o valor
analisado :
LEADING(Amount;3) = "623"
LEADING(Amount;5) = "62345"
LENGTH( )
LENGTH( ) retorna o comprimento de uma cadeia especfica.
Formato da funo
LENGTH(C)
56
Manual de Referncia
Exemplos
LENGTH("ABCDE")=5
Para criar um campo que contenha o comprimento do campo Name sem os espaos
em branco direita, especifique:
LENGTH(TRIM(Name))
LOGARITHM( )
LOG( ) retorna o logaritmo (base 10) de uma expresso numrica ou campo de valor
com o nmero especificado de casas decimais.
LOG( ) o inverso da funo EXP( ).
Use LOG( ) para aplicativos financeiros que necessitem de clculos matemticos
complexos.
Formato da funo
LOGARITHM(N;#)
Onde # uma constante numrica representando casas decimais que no podem ser
alteradas de registro para registro.
LOG( ) retorna o logaritmo comum (base 10) da expresso numrica ou valor de campo
N com # casas decimais. O logaritmo de um nmero o expoente (ou potncia) de dez
Exemplos
LOG(1000;4) = 3,0000
LOG(72443;2)= 4,86
Para criar um campo que seja a raiz cbica do campo X com duas casas decimais,
especifique:
EXP(LOG(X;6):3;2)
Captulo 2
Funes
LOWER( )
57
LOWER( )
LOWER( ) converte todos os caracteres alfabticos de uma expresso ou campo para
minsculo.
Use LOWER( ) ao procurar dados que misturam maisculo/minsculo ou que no se
conhea a forma, ou quando se deseja que os caracteres estejam em minsculo, para fins
de formatao.
LOWER( ) o inverso da funo UPPER( ).
Formato da funo
LOWER(C)
Exemplos
LOWER("ABC")= "abc"
LOWER("abc 123 DEF")= "abc 123 def"
LOWER("AbCd 12")= "abcd 12"
LTRIM( )
LTRIM( ) retorna uma cadeia de comprimento varivel com todos os espaos em
branco esquerda (iniciais) removidos.
LTRIM( ) similar funo TRIM( ), que remove quaisquer espaos em branco
direita (finais) de uma cadeia e a ALLTRIM( ), que remove os espaos em branco nas
duas extremidades.
Formato da funo
LTRIM(C)
58
Manual de Referncia
Exemplos
LTRIM("
AB C ")="AB C "
LTRIM("ABC")="ABC"
LTRIM(" A ")="A "
MAP( )
MAP( ) executa uma comparao caractere a caractere de uma cadeia de origem com
uma cadeia de formatao especificada e retorna um valor Verdadeiro ou Falso. A
cadeia de formatao pode conter quaisquer caracteres curinga, caracteres literais ou
ambos.
Use MAP( ) para executar comparaes de curinga ou literais no ACL, especialmente
para criar filtros que no estejam baseados em texto literal.
Formato da funo
MAP(C1;C2)
Para:
X,x
Captulo 2
Funes
MASK( )
59
Os espaos em branco podem ser inseridos como espaos em branco, sem \ na frente.
Use \ antes de qualquer caractere de formatao que deve estar literalmente presente
na cadeia de formatao. Por exemplo, para especificar X como literal, insira \X na
cadeia de formatao. Para especificar uma barra invertida como literal, insira \\.
Uma nica \ como o ltimo caractere na cadeia C2 ser ignorada.
Exemplos
MAP("ABC123";"xxx999") = T
MAP("ABC123";"XX999") = F
MAP("A bc123";"X XX999") = T
MAP("A bc123";"XXX999") = F
MAP("ABC123";"ABC999) = T
MAP("ABC123";"XXC999") = T
MAP("WXY123";"W\XY999") = T
MAP("ABC123";"XXX 9999") = F
MAP("A1 B23";"XXXX") = F
MAP("A1 B23";"!!!!") = F
MASK( )
MASK( ) extrai bits individuais do primeiro byte de uma expresso com caracteres.
Use MASK( ) para identificar padres de bits especficos em um byte de dados.
Formato da funo
MASK(C1;C2)
MASK( ) executa uma operao AND lgica orientada por bits nos primeiros caracteres
de C1 e C2 retornando uma cadeia de um caractere de comprimento. Se qualquer
parmetro for maior que um byte, os caracteres seguintes sero ignorados. O uso
normal ter o byte em questo como C1 e um valor de mscara como C2.
Uma operao AND orientada por bits compara dois bytes, um bit por vez. O resultado
para cada posio de bit ser 1, se os dois bits correspondentes forem 1. Caso contrrio,
o resultado ser 0 para aquele bit.
Exemplo
MASK("A";CHR(15)) = CHR(1)
60
Manual de Referncia
MATCH( )
MATCH( ) compara uma expresso ou valor de campo de qualquer tipo com uma srie
de expresses especificadas ou valores de campo, a fim de determinar se existe no
mnimo uma correspondncia. O valor retornado ser verdadeiro ou falso.
Use MATCH( ) para eliminar a necessidade de repetir argumentos em um teste.
Formato da funo
MATCH(valor_da comparao;teste 1;teste 2 <;teste 3...>)
Exemplos
MATCH(7;1;3;5;7;9) = T
Captulo 2
Funes
MAXIMUM( )
61
Para extrair todos os registros para a diviso de pesquisa, entre com Research na caixa
de texto de condio.
Extrair registros
Condio
Nome do arquivo extrado
MAXIMUM( )
MAXIMUM( ) retorna o maior de dois nmeros.
MAXIMUM( ) o oposto da funo MINIMUM( ).
62
Manual de Referncia
Formato da funo
MAXIMUM(N1;N2)
Se N1 for maior que N2, MAXIMUM( ) retorna N1. De outra forma, retorna N2.
Se o nmero de decimais nos dois parmetros for diferente, o resultado ser ajustado
para o maior nmero de decimais.
Exemplos
MAX(4;7)= 7
MAX(7,5;4)= 7,5
MAX(7;4,55)= 7,00
Se voc tiver um arquivo de contas vencidas, para criar um campo Juros_a_pagar com
um valor mnimo de R$1,00 ou mais, especifique:
MAXIMUM(Saldo * Taxa_anual;1)
Se o saldo multiplicado pela taxa de juros for menor que 1 real, MAX( ), retorna 1.
Seno, MAX( ) retorna o valor dos juros calculados.
MINIMUM( )
MINIMUM( ) retorna o menor dos dois nmeros especificados.
MINIMUM( ) o oposto da funo MAXIMUM( ).
Formato de funo
MINIMUM(N1;N2)
Se N1 for menor que N2, MINIMUM( ) retorna N1. Seno, retornar N2.
Se o nmero de decimais nos dois nmeros for diferente, MINIMUM( ) ajustar o
resultado ao maior nmero de decimais.
Exemplos
MIN(4;7)= 4
MIN(7,5;4)= 4,0
MIN(7;4,55) = 4,55
Em um arquivo de estoque, para criar um campo que contenha o menor preo de custo
e de venda, especifique:
MINIMUM(Custo;Venda)
Captulo 2
Funes
MOD( )
63
MOD( )
MOD( ) divide dois nmeros e retorna o resto.
Use MOD( ) para testar se dois nmeros divididos tm resultado exato ou para isolar o
resto de um clculo de diviso.
Formato da funo
MOD(N1;N2)
MOD( ) retorna o resto da diviso de N1 por N2. O resto tem o mesmo nmero de
decimais que o maior dos dois nmeros.
Exemplos
MOD(93;10)= 3
MOD(66;16,00)= 2,00
MOD(53,45;10)= 3,45
NOMINAL( )
NOMINAL( ) calcula a taxa de juros nominal anual de um emprstimo.
Use NOMINAL( ) para determinar a taxa de juros nominal anual, considerando a taxa
efetiva e o nmero de perodos compostos por ano. Por exemplo, se voc sabe qual a
taxa efetiva anual de seu carto de crdito, mas deseja saber qual a taxa realmente
utilizada para calcular os juros mensais, deve usar essa funo. Para obter mais informaes, consulte Funes financeiras na pgina 286 do Guia do Usurio do
ACL para Windows.
Formato da funo
NOMINAL(taxa_efetiva; perodos)
taxa_efetiva a taxa de juros anual efetiva.
perodos o nmero de perodos compostos por ano. perodos truncado para um
inteiro.
O resultado ser retornado para oito casas decimais, 0,12345678 ou 12,345678%.
Essa funo o oposto de EFFECTIVE( ).
64
Manual de Referncia
Se voc entrar com um parmetro obviamente invlido, como uma taxa de juros
negativa, o ACL retorna um erro.
Exemplo
Se voc sabe que a taxa efetiva anual de seu carto de crdito de 19,56%, para calcular
a taxa usada mensalmente, especifique:
NOMINAL(0,1956;12) = 0,17998457
NPER( )
NPER( ) calcula o nmero de perodos necessrios para liquidar um emprstimo.
Use NPER( ) para determinar quanto tempo ser necessrio para reembolsar uma
dvida. Por exemplo, se voc estiver pagando R$500 por ms pelo financiamento de seu
carro, poder usar essa funo para saber quando a dvida ser liquidada. Para obter
mais informaes, consulte Funes financeiras na pgina 286 do Guia do Usurio do
ACL para Windows.
Formato da funo
NPER(taxa;pagamento;montante)
taxa a taxa de juros por perodo.
pagamento o pagamento efetuado a cada perodo.
montante o montante em que os pagamentos se baseiam.
Exemplo
Para calcular o nmero de perodos necessrios para o reembolso de um emprstimo de
1.000 com pagamentos mensais de 50 a 8%:
NPER(,08/12;50;1000) = 21,54
Captulo 2
Funes
OCCURS( )
65
OCCURS( )
OCCURS( ) conta o nmero de vezes que uma cadeia de caracteres ocorre em outra
cadeia de caracteres.
Voc pode utilizar OCCURS( ), por exemplo, para pesquisar quantas vezes New York
ocorre em um campo de endereo.
Formato da funo
OCCURS(C1;C2)
Exemplos
OCCURS("abc/abc/a";"ab") = 2
OCCURS("abc/abc/a";"a") = 3
OFFSET( )
OFFSET( ) ajusta a posio inicial de um campo no registro atual.
Use OFFSET( ) para processar dados de ocorrncia varivel, como aqueles definidos
com a clusula OCCURS do COBOL. possvel tambm, utilizar OFFSET( ) em estruturas de registro muito complexas (como arquivos SMF da IBM), nas quais um bloco de
dados tem uma posio inicial varivel ou em um arranjo que contenha uma matriz
tendo um nmero varivel de valores.
Formato da funo
OFFSET(F;N)
66
Manual de Referncia
Exemplos
Considerando o registro 01234567890 e um campo numrico X, iniciando na posio
1 com um comprimento de 3 e nenhuma casa decimal:
X = 12
OFFSET(X;1) = 123
OFFSET(X;6) = 678
PACKED( )
PACKED( ) converte um nmero em um tipo de campo compactado com comprimento
especificado.
Use PACKED( ) para criar dados numricos em formato compactado. Isso pode ser
necessrio ao se criar dados a serem lidos por aplicaes externas. Para obter mais informaes sobre o tipo de campo compactado, consulte Packed (Compactado) na
pgina 18.
Consulte UNSIGNED( ) na pgina 85 para um mtodo alternativo para converso de
dados numricos.
Formato da funo
PACKED(N1;#)
PACKED( ) converte N1 em dados tipo PACKED com o comprimento, em bytes, especificado por #. Se # for muito pequeno para armazenar todos os dgitos de N1, os dgitos
significativos so truncados.
Nota: Como a sada a partir dessa funo no pode ser impressa, voc deve inclu-la
normalmente apenas na criao de um arquivo. Uma exibio no mostrar os dados,
como era de se esperar.
Captulo 2
Funes
PMT( )
67
Exemplos
PACKED(75;3)= 00075C (hex)
PACKED(7,5;3)= 00075C (hex)
PACKED(-12,456;6)= 00000012456D (hex)
PACKED(-12,456;2)= 456D (hex)
PMT( )
PMT( ) calcula o pagamento peridico necessrio para liquidar uma dvida.
Use PMT( ) a fim de determinar o pagamento necessrio para liquidar um investimento
ou emprstimo, presumindo pagamentos constantes e uma taxa de juros fixa. Por
exemplo, se voc pegar um emprstimo, poder usar essa funo para determinar o
montante dos pagamentos. Para obter mais informaes, consulte Funes financeiras na pgina 286 do Guia do Usurio do ACL para Windows.
Formato da funo
PMT(taxa;perodos;montante)
taxa a taxa de juros por perodo.
perodos o nmero total de perodos de pagamento em uma anualidade.
montante o valor presente; o montante do investimento a ser liquidado.
O pagamento retornado por PMT( ) inclui apenas o principal e os juros, e presume que
os pagamentos sero efetuados ao final de cada perodo.
O resultado retornado com duas casas decimais.
Se voc entrar com um parmetro obviamente invlido, como uma taxa de juros
negativa, o ACL retorna um erro.
Exemplo
Se voc deseja determinar os pagamentos mensais necessrios para liquidar um
emprstimo de R$10.000 em 24 meses, a uma taxa de 8% composta mensalmente,
especifique:
PMT(,08/12;24;10000) = 452,27
68
Manual de Referncia
PROPER( )
PROPER( ) converte caracteres alfabticos em uma cadeia ou campo em caracteres
misturados maisculo/minsculo, conforme necessrio para uma representao de
nome prprio.
PROPER( ) til para tarefas como produo de cartas de confirmao.
Formato da funo
PROPER(C)
A funo PROPER( ) toma uma nica cadeia de caracteres (C) e a converte em maisculas e minsculas do modo apropriado para representar nomes prprios. PROPER( )
usa a regra de que o primeiro caractere alfabtico convertido em letra maiscula e os
caracteres seguintes convertidos em minsculas. Consulte tambm, UPPER( ) na
pgina 85 e LOWER( ) na pgina 57, que converte caracteres alfabticos em
maisculo e minsculo, respectivamente.
Exemplos
PROPER("JOHN DOE")= "John Doe"
PROPER("john doe")= "John Doe"
PROPER("123 AnyWhere St.")= "123 Anywhere St."
PROPER("BILL O'HARA")= "Bill O'Hara"
PVANNUITY( )
PVANNUITY( ) calcula o valor presente de uma srie de pagamentos.
Use PVANNUITY( ) quando quiser determinar o valor presente de uma srie de
pagamentos futuros. Por exemplo, ao tomar um emprstimo em dinheiro, o montante
do emprstimo o valor presente para o credor. Para obter mais informaes, consulte
Funes financeiras na pgina 286 do Guia do Usurio do ACL para Windows.
Formato da funo
PVANNUITY(taxa; perodos; valor)
taxa a taxa de juros por perodo.
perodos o nmero total de perodos de pagamento em uma anualidade.
valor o pagamento efetuado ao final de cada perodo e no pode mudar durante a
anuidade.
Captulo 2
Funes
PVLUMPSUM( )
69
PVANNUITY( ) presume um valor futuro zero e calcula o resultado com base nos
pagamentos efetuados ao final do perodo.
Se voc entrar com um parmetro obviamente invlido, como uma taxa de juros
negativa, o ACL retorna um erro.
Exemplo
A uma taxa de juros anual de 8%, para calcular o valor a receber de R$500 ao ms
durante os prximos vinte anos, especifique:
PVA(0,08/12;12*20;500) = 59.777,15
PVLUMPSUM( )
PVLUMPSUM( ) calcula o valor presente de uma soma global a ser paga em vrios
perodos.
Use PVLUMPSUM( ) para determinar o valor presente de um montante a ser recebido
ou pago no futuro. O valor presente o montante de um pagamento com vencimento
futuro, com base em uma taxa de juros presumida. Por exemplo, se voc deve dinheiro
em uma data futura, o valor presente o montante necessrio a ser depositado agora no
banco, com juros compostos, para cobrir a dvida no vencimento. Para obter mais informaes, consulte: Funes financeiras na pgina 286 do Guia do Usurio do
ACL para Windows.
Formato da funo
PVLUMPSUM(taxa;perodos;montante)
taxa a taxa de juros por perodo.
perodos o nmero total de perodos.
valor o pagamento efetuado ao final de cada perodo.
Exemplo
Presumindo uma taxa de juros anual de 11%, composta mensalmente, o valor presente
de $10.000 a pagar em trs anos :
PVLUMPSUM(0,11/12;3*12;10000) = 7.200,05
70
Manual de Referncia
RAND( ) ou RND( )
RAND( ) ou RND( ) retorna um nmero aleatrio entre zero e o valor de uma
expresso numrica especificada ou valor de campo.
Use RAND( ) quando voc precisar gerar um nmero aleatrio para usar dentro ou fora
do ACL.
Formato da funo
RANDOM(N) ou RND(N)
Exemplos
RAND(1000,00)= 278,61
RND(10000)= 3781
RATE( )
RATE( ) calcula a taxa de juros por perodo, implcita em uma anualidade.
Use RATE( ) para determinar a taxa de juros que est sendo paga em uma anualidade.
Por exemplo, se voc tem a opo de fazer leasing ou de comprar determinado produto,
pode usar essa funo para determinar a taxa de juros implcita no leasing. Para obter
mais informaes, consulte Funes financeiras na pgina 286 do Guia do Usurio do
ACL para Windows.
Formato da funo
RATE(perodos; pagamento; montante)
perodos o nmero total de perodos.
pagamento o pagamento efetuado a cada perodo.
montante o montante no qual os pagamentos se baseiam.
Captulo 2
Funes
RECLEN( )
71
Exemplo
Para calcular a taxa implcita em um emprstimo de $8.000 para liquidao em quatro
anos, com pagamentos mensais de R$200, especifique:
RATE(48;200;8000) = 0,00770147
Essa a taxa mensal porque o perodo mensal. A taxa anual de 0,0077*12, que corresponde a 9,24% compostos mensalmente, ou a uma taxa efetiva anual de 9,64% (usando
a funo EFFECTIVE( )).
RECLEN( )
RECLEN( ) retorna o comprimento do registro atual.
Use RECLEN( ) para testar registros pequenos ou para registros de um comprimento
determinado. especialmente til com arquivos (relatrio) CR/LF, porque fornece um
modo fcil para examinar os comprimentos dos registros.
Formato da funo
RECLEN()
72
Manual de Referncia
Exemplo
Para extrair todos os registros cujo comprimento exatamente 110 (presumindo que
esse o tipo de registro de seu interesse), especifique:
RECLEN( ) = 110
Extrair registros
Condio
Nome de arquivo extrado
RECNO( )
RECNO( ) retorna o nmero de registro lgico atual, contando a partir de 1.
Use RECNO( ) para gravar nmeros de registro em um arquivo, ou quando examinar
um arquivo pela primeira vez para determinar a localizao relativa de um determinado
registro.
Formato da funo
RECNO()
Captulo 2
Funes
REMOVE( )
73
Exemplo
Para o registro 99:
RECNO() = 99
REMOVE( )
REMOVE( ) retira os caracteres indesejados de uma cadeia de caracteres ou valor de
campo.
Use REMOVE( ) para normalizar campos de dados que no tm um formato consistente, como campos de endereo. Essa funo tambm til para remover pontuaes
ou outras informaes invlidas de campos editados incorretamente, ou que no
tiveram edies de entrada aplicadas. REMOVE( ) pode ser necessria antes da
execuo subseqente dos comandos Ordenar ou Associar ou para tornar os dados
mais regulares para formatao ou correspondncia de duplicidades.
Nota: Esta funo foi substituda pelas funes INCLUDE( ) e EXCLUDE( ). Ainda est
disponvel na verso atual para compatibilidade com verses anteriores do ACL para
Windows.
Formato da funo
REMOVE(C1;C2)
74
Manual de Referncia
Exemplos
REMOVE("ABC 123 XX4"; "ABC123")= "ABC123"
REMOVE("ABC 123 XX4"; "ABCX123")= "ABC123XX"
REMOVE("ABC 123 XX4"; "1234567890")= "1234"
REPEAT( )
REPEAT( ) retorna uma cadeia que repete um valor constante por um nmero especificado de vezes.
Use REPEAT( ) para inicializar uma varivel com valores constantes ou espaos em
branco, ou para configurar um valor padro para um campo calculado. til para
aplicativos de programao avanada.
Formato da funo
REPEAT(C;#)
Exemplos
REPEAT("ABC";3) = "ABCABCABC"
REPEAT("0";9) = "000000000"
REPLACE( )
REPLACE( ) substitui todas as instncias de uma cadeia de caracteres especificada por
uma nova cadeia de caracteres.
Use REPLACE( ) para normalizar campos de dados com formatos inconsistentes, como
campos de endereo, ou para substituir informaes invlidas em campos com edio
deficiente. Tambm possvel usar REPLACE( ) para obter consistncia na formatao,
para correspondncia de duplicidades e para os comandos Associar e Relacionamentos,
que exigem campos idnticos.
Tambm possvel usar REPLACE( ) para remover uma cadeia de caracteres especfico
de uma cadeia de origem, substituindo-a por uma cadeia de caracteres vazios().
Captulo 2
Funes
REPLACE( )
75
Formato da funo
REPLACE(C1;C2;C3)
Exemplos
REPLACE ("abcdefg";"bcd";"12345") = "a12345efg"
REPLACE("Road";"Road";"Rd.") = "Rd. "
REPLACE("abc";"b";"") = "ac "
"
Agora use
REPLACE("abc/abc/abc ";"b";"12") = "a12c/a12c/a12c"
76
Manual de Referncia
"
REVERSE( )
REVERSE( ) inverte a ordem dos caracteres em uma cadeia.
Formato da funo
REVERSE(C)
Exemplo
REVERSE("ABCD E") = "E DCBA"
RJUSTIFY( )
RJUSTIFY( ) retorna uma cadeia alinhada para a direita com o mesmo comprimento
que a cadeia especificada, com todos os espaos em branco no final movidos para o
incio da cadeia.
Use RJUSTIFY( ) para alinhar um campo direita.
Formato da Funo
RJUSTIFY(C)
Exemplo
RJUSTIFY("ABC
") = "
ABC"
ROOT( )
ROOT( ) retorna a raiz quadrada de uma expresso numrica ou valor de campo. Voc
deve especificar o nmero de casas decimais no resultado.
Formato da funo
ROOT(N;#)
Onde # uma constante numrica representando casas decimais que no podem ser
alteradas de registro para registro.
Captulo 2
Funes
ROUND( )
77
Exemplos
ROOT(100;2) = 10,00
ROOT(1000;4)= 31,6228
ROUND( )
ROUND( ) retorna um nmero inteiro arredondado de uma expresso numrica ou
valor de campo.
Use ROUND( ) sempre que desejar arredondar uma expresso para o nmero inteiro
mais prximo.
Formato da funo
ROUND(N)
Exemplos
ROUND(7,2) = 7
ROUND(7,5)= 8
ROUND(-7,5)= -8
Para criar um campo igual ao saldo arredondado para o valor monetrio mais prximo,
especifique:
ROUND(Saldo)
SHIFT( )
SHIFT( ) move bits no primeiro caractere de uma expresso ou valor de campo,
esquerda ou direita, por um nmero especificado de bits.
Use SHIFT( ) em conjunto com as funes BYTE( ), CHR( ) e MASK( ) para isolar e
mover bits individuais em um registro.
78
Manual de Referncia
Formato da funo
SHIFT(C;N)
Exemplos
SHIFT(CHR(22);2) = CHR(88)
SOUNDEX( )
SOUNDEX( ) retorna um valor de quatro caracteres para uma cadeia especfica, que
pode ser comparado ao valor de outra cadeia, a fim de verificar se ambas so foneticamente similares.
Esta funo til se voc deseja localizar itens com entradas em duplicidade ou itens
soletrados de forma inconsistente.
O primeiro caractere no valor representa a primeira letra na cadeia. Os prximos trs
caracteres no valor representam grupos de consoantes foneticamente similares na
cadeia. SOUNDEX( ) ignora caracteres maisculos e vogais na cadeia e utiliza apenas os
trs primeiros grupos de consoantes em argumentos longos.
Para obter um mtodo alternativo de cadeias foneticamente correspondentes, consulte
SOUNDSLIKE( ) na pgina 79.
Captulo 2
Funes
SOUNDSLIKE( )
79
Formato da funo
SOUNDEX(C)
Exemplos
SOUNDEX("Fairview Ind") = "F615"
SOUNDEX("Fairview Media") = "F615"
SOUNDEX("Fairviews Media") = "F612"
SOUNDSLIKE( )
SOUNDSLIKE( ) retorna Verdadeiro ou Falso para indicar quando duas cadeias tm
sons foneticamente parecidos.
SOUNDSLIKE( ) primeiramente converte as cadeias em cdigos de quatro caracteres,
conforme descrito em SOUNDEX( ). A seguir, compara o cdigo do SOUNDEX( ) de
cada cadeia e retorna Verdadeiro se os cdigos forem iguais e Falso se no forem iguais.
Esta funo no distingue entre maisculo e minsculo, portanto SMITH equivalente a smith.
Use SOUNDSLIKE( ) para identificar itens cujos sons sejam similares, para fins de
correspondncia.
Formato da funo
SOUNDSLIKE(C1;C2)
Exemplos
SOUNDSLIKE("Fairview Media"; "fairview ind") = T
SOUNDSLIKE("Fairviews Media"; "fairview ind") = F
SPLIT( )
SPLIT( ) divide uma cadeia de caracteres em segmentos separados por caracteres como
espaos ou vrgulas, e retorna um segmento especificado. Qualquer caractere ou cadeia
pode ser usada como separador.
80
Manual de Referncia
Formato da funo
SPLIT(C1;C2;N)
Exemplos
SPLIT("abc,def,ghijkl";",";2) = "def"
SPLIT("abc,def,ghijkl";",";3) = "ghijkl"
SPLIT("abc/*def/*ghijkl";"/*";3) = "ghijkl"
SPLIT("Jane Doe";" ";2) = "Doe"
SPLIT("/abc/efg/";"/";2) = "abc"
SPLIT("abc,def,,ghi";",";3) = ""
STRING( )
STRING( ) converte uma expresso numrica ou valor de campo em uma cadeia de
caracteres.
Use STRING( ) para converter uma expresso numrica ou valor de campo em formato
de caractere para usar como um campo-chave em um comando do ACL, como Resumir
ou Associar.
Formato da funo
STRING(N;# <;C>)
Captulo 2
Funes
SUBSTRING( )
81
Exemplos
STRING(125,2;7) = " 125,2"
STRING(-125,2;4) = "25,2"
STRING(-125,2;7)= " -125,2"
Para criar um campo que converta o campo PACKED Custo em uma cadeia de forma
que possa ser utilizada como um campo-chave, especifique:
STRING(Custo;8)
SUBSTRING( )
SUBSTR( ) retorna uma subcadeia de uma expresso com caracteres ou valor de campo.
Use SUBSTRING( ) para isolar uma parte de uma expresso com caracteres ou valor de
campo.
Formato da funo
SUBSTRING(C;N1;N2)
Exemplos
SUBSTR("ABCDEF";2;3)="BCD"
Para extrair o ano de um campo de caracteres que contm uma data no formato
MM/DD/AAAA , especifique:
SUBSTR(DATE;7;4)
82
Manual de Referncia
TEST( )
TEST( ) retorna Verdadeiro se uma cadeia de texto especificada for iniciada em uma
localizao de byte especificada em um registro. Caso contrrio, TEST( ) retornar
Falso.
TEST( ) ser automaticamente usado quando voc criar um filtro na janela Criar um
filtro de dados. Esta a forma mais adequada para fazer referncia funo TEST( ).
Formato da funo
TEST(N;C)
Exemplos
Dado um registro contendo:
Dept Name: Marketing
....|....1....|....2...
TEST(5;'Dept') = T
TEST(6;'Dept') = F(Dept inicia na posio 5, no em 6)
TEST(5;'DEPT') = F(no maisculo)
TIME( )
TIME( ) retorna a hora e data do relgio do sistema.
Use TIME( ) para determinar a hora atual ou a durao de tarefas especficas.
Captulo 2
Funes
TIME( )
83
Formato da funo
TIME()
Exemplo
TIME( ) = "15:38:52"
Esses clculos usam partes separadas da hora e calculam o nmero de segundos a partir
da meia-noite, antes e aps as operaes.
84
Manual de Referncia
TRANSFORM( )
TRANSFORM( ) inverte a ordem de exibio dos dados bidirecionais em uma cadeia de
caracteres ou campo.
Use TRANSFORM( ) para fazer com que caracteres hebraicos sejam exibidos corretamente.
Formato da funo
TRANSFORM(C)
Exemplo
TRANSFORM("ABC ZYX 123") = "ABC XYZ 123"
TRIM( )
TRIM( ) retorna uma cadeia de comprimento varivel com todos os espaos em branco
finais removidos.
TRIM( ) similar funo LTRIM( ), que remove os espaos em branco esquerda
(iniciais) de uma cadeia e a ALLTRIM( ), que remove os espaos em branco em ambas
as extremidades.
Formato da funo
TRIM(C)
A cadeia C ser copiada para o resultado e os espaos em branco finais sero omitidos.
Exemplos
TRIM("
AB C ") = "
TRIM("ABC") = "ABC"
TRIM(" A ") = " A"
AB C"
Dados os dois campos Primeiro e ltimo, para criar um campo Nome no formato Last,
First, especifique:
TRIM(ltimo) + ',' + TRIM(Primeiro)
Captulo 2
Funes
UNSIGNED( )
85
UNSIGNED( )
UNSIGNED( ) converte um nmero em um tipo de dado sem sinal de um comprimento
especificado.
Use UNSIGNED( ) para criar dados numricos em formato sem sinal. Isto pode ser
necessrio ao criar dados para serem lidos por aplicaes externas. Para obter mais
informaes sobre campos sem sinal consulte Unsigned (Sem sinal) na pgina 22.
Consulte PACKED( ) na pgina 66 para obter um mtodo alternativo de converso de
dados numricos.
Formato da funo
UNSIGNED(N1;#)
Nota: Como a sada a partir dessa funo no pode ser impressa, voc deve inclu-la
apenas em em conjunto com a criao de um arquivo. Uma exibio no mostrar os
dados como esperado.
Exemplos
UNS(75;3)= 000075 (hex)
UNS(-75;3)= 000075 (hex)
UNS(7,5;3)= 000075 (hex)
UNS(12456;2)= 2456 (hex)
UPPER( )
UPPER( ) converte todos os caracteres alfabticos de uma expresso ou valor de campo
em maisculo.
Use UPPER( ) ao pesquisar dados com formatos maisculo/minsculo misturados ou
quando o formato for desconhecido.
Formato da funo
UPPER(C)
86
Manual de Referncia
Exemplos
UPPER("ABC")= "ABC"
UPPER("abc 123 DEF")= "ABC 123 DEF"
UPPER("AbCd 12")= "ABCD 12"
Se for necessrio usar maisculo, voc poder identificar todos os clientes chamados
Smith especificando:
UPPER(NAME) = "SMITH"
VALUE( )
VALUE( ) converte uma expresso com caracteres ou campo no equivalente numrico.
Use VALUE( ) se voc precisar converter uma expresso com caracteres ou valor de
campo para formato numrico, a fim de usar com os comandos do ACL.
VALUE( ) retorna o equivalente numrico de uma expresso com caracteres ou valor de
campo com um nmero especificado de casas decimais. Se o ajuste decimal resultar na
perda de decimais, o resultado ser arredondado.
VALUE( ) aceita nmeros em qualquer formato. possvel usar como entrada qualquer
formatao numrica aceita pelo tipo de campo de impresso, como pontuao, sinais
esquerda ou direita, e parnteses.
Se uma cadeia como 123 no contiver decimais, o ACL trata o nmero como inteiro.
Por exemplo, ao converter (123; 2), ao especificar duas casas decimais, o ACL interpreta 123 como 123,00 e no 1,23.
Compare VALUE( ) a STRING( ).
Formato de funo
VALUE(C;#)
Onde # uma constante numrica que no pode ser alterada de registro para registro.
Exemplos
VALUE("123,4-";3) = -123,400
VALUE("$123,456";2) = 123456,00
VALUE("77,45CR";2) = -77,45
VALUE(" (123.456,78)";0)= -123457
Captulo 2
Funes
VERIFY( )
87
VERIFY( )
VERIFY( ) determina se um campo contm dados vlidos e, se isso acontecer, retorna
Verdadeiro.
Como o comando Verificar e a opo de preferncia Verificar dados no permitem um
controle muito preciso, voc poder usar a funo VERIFY( ) para detectar erros em
campos individuais e prosseguir de acordo com uma situao especfica. Para obter
mais informaes, consulte Verify (Verificar) na pgina 341 e Verificar dados na
pgina 326 do Guia do Usurio do ACL para Windows.
Formato da funo
VERIFY(Campo)
Exemplo
Para criar um filtro que identifique dados invlidos no campo Prodno (que voc
poder usar para extrair os registros incorretos), especifique:
VERIFY(PRODNO) = F
ZONED( )
ZONED( ) converte uma expresso numrica ou valor de campo no formato de dados
ZONED do ASCII.
Use ZONED( ) para exportar dados para outras aplicaes, como programas capazes de
gerar uma sada impressa, que necessitem de arquivos de dados zonados como entrada.
Tambm possvel utilizar ZONED( ) para converter um valor numrico positivo em
um valor de caractere contendo zeros esquerda. Isto til para a normalizao de
dados em campos a ser utilizados como campos-chave. Por exemplo, se um arquivo
contm nmeros de faturas no formulrio 100 em um campo numrico, e outro arquivo
contm nmeros de faturas no formulrio 00100 em um campo de caracteres, voc
pode utilizar ZONED( ) para converter o valor numrico 100 no valor de caractere
00100. Isto permite comparar nmeros de faturas semelhantes.
Formato da funo
ZONED(nmero; comprimento)
nmero especifica a expresso numrica ou valor de campo.
88
Manual de Referncia
Exemplo
ZONED(-6448,95;11) = "0000064489N"
ZSTAT( )
ZSTAT( ) calcula a estatstica-Z para uso em muitas tarefas de soluo de problemas,
incluindo anlise digital. Ela retorna uma resposta com trs casas decimais.
Use ZSTAT( ) para avaliar a freqncia com maior probabilidade de ocorrncia de um
determinado resultado em um perodo ou categoria especificado. Quanto maior a
estatstica-Z resultante, menor a probabilidade de ocorrncia. Por exemplo, uma
estatstica-Z de 1,96 tem uma significncia de 0,05, representando a probabilidade de
uma em 20 ocorrncias, enquanto uma estatstica-Z de 2,57 tem uma significncia de
0,01, representando a probabilidade de uma em 100 ocorrncias. Para obter informaes sobre estatstica-Z, consulte um livro de estatstica.
possvel especificar os parmetros para ZSTAT( ) como nmeros ou propores:
iniciais.
v2 representa a contagem prevista, como um dgito inicial ou uma combinao de
dgitos iniciais.
Captulo 2
Funes
ZSTAT( )
89
v3 representa o nmero total de itens sendo testados e deve ser um nmero inteiro
Uma estatstica Z de 1,96 tem uma significncia de 0,05 e 2,57 tem uma significncia de
0,01. Portanto, a probabilidade de que as taxas mais altas de ocorrncias sejam devidas
ao acaso fica entre 1:20 e 1:100.
Resultados baixos. O nmero real de ocorrncias em julho e agosto foi de 390. O
nmero previsto de ocorrncias para esse perodo um sexto das ocorrncias anuais de
2.450, ou seja, 408,33. A estatstica-Z para essas propores :
ZSTAT(390;408,33;2450) = 0,967
exclusive.
v3 representa o nmero total de itens sendo testados e deve ser um nmero inteiro
90
Manual de Referncia
1,00000000 retornar a maior preciso possvel. Para obter mais informaes, consulte
Aritmtica de ponto fixo na pgina 284 do Guia do Usurio do ACL para Windows.
Exemplo com parmetros expressos como propores
Com base em 10 anos de dados anteriores, voc sabe que a distribuio de reclamaes
trabalhistas por acidentes por ms altamente uniforme e crescente. Em abril, maio e
junho deste ano, as reclamaes foram superiores em, aproximadamente, 10%, perfazendo uma mdia de 220 por ms, ao invs de 200. As reclamaes em julho e agosto
foram ligeiramente inferiores, de 193 e 197. O total de reclamaes do ano foi de 2.450.
Para verificar se os resultados altos e baixos foram significativos, use a estatstica-Z.
Resultados altos. O nmero real de reclamaes para abril a junho representado pela
proporo 660/2450. O nmero esperado de reclamaes para este perodo deve ser de
25% das reclamaes anuais de 2.450. A estatstica-Z para essas propores :
ZSTAT((1,00000000*660/2450);0,25;2450)=2,193
Uma estatstica-Z de 1,96 tem uma significncia de 0,05, e 2,57 tem uma significncia de
0,01. Portanto, a probabilidade de que taxas superiores de reclamaes sejam devidas ao
acaso est entre 1:20 e 1:100.
Resultados baixos. O nmero real de reclamaes para julho e agosto 390. O nmero
esperado de reclamaes para este perodo deve ser um sexto, ou 16,6667 por cento das
2.450 reclamaes anuais. A estatstica-Z para essas propores :
ZSTAT((1,00000000*390/2450);0,16667;2450)=0,967
All (Tudo)
Tudo usado para especificar at que ponto um comando executado em campos ou
registros.
91
92
Manual de Referncia
Append (Anexar)
Anexar/Anexar a um arquivo existente um parmetro de escopo que adiciona a sada
produzida por um comando no final de um arquivo existente, em vez de substituir seu
contedo (sobrescrever). Esse parmetro vlido apenas quando o comando cria um
arquivo de sada.
Nota: Certifique-se de que a estrutura dos dois arquivos idntica, antes de usar esta
opo. O ACL anexa uma sada a um arquivo existente, qualquer que seja sua estrutura.
As (Como)
Como um modificador de campo usado para especificar um nome de substituio
para um campo existente ou expresso especfica.
Se Como for usado em um comando que cria outro arquivo, o nome especificado na
clusula Como ir se tornar o nome do campo, na nova definio de arquivo de entrada.
Uma vez que o nome uma cadeia de caracteres, qualquer expresso de caractere
vlida, desde que siga as convenes de nomeao de campos do ACL.
Como pode ser usado somente no modo de comando.
Captulo 3
93
Ascending (Crescente)
Crescente um modificador de campo que especifica a ordem de classificao-padro
para campos-chave, incluindo campos calculados e expresses especficas. Ascendente
pode ser usado somente nos comandos Duplicates (Duplicidades), Gaps (Falhas), Index
(ndice), Sort (Ordenar) e Sequence (Seqncia).
94
Manual de Referncia
Break (Quebra)
Quebra especifica campos de quebra em um comando e faz com que dados de relatrio
sejam quebrados sempre que o valor do campo especificado for alterado. Os subtotais
so gerados para cada valor no campo de quebra. Quebra tambm pode ser usada com
uma expresso que consiste em uma concatenao de mais de um campo.
Os campos de quebra devem ser campos de caracteres. Para usar Quebra em um campo
numrico, converta-o em campo de caractere usando a funo STRING ( ). Quebra
pode ser usada somente com os seguintes comandos: Classificar, Estratificar, Histograma e Perodo.
Nota: Para obter resultados significativos, seu arquivo deve estar previamente ordenado
ou indexado no campo especificado por Quebra.
Para obter mais informaes sobre o uso de colunas de quebras em exibies e
relatrios, consulte Modificar colunas na pgina 203 do Guia do Usurio do
ACL para Windows e Especificar colunas de quebra na pgina 204 do Guia do Usurio
do ACL para Windows. Para obter mais informaes sobre a insero de quebra de
pgina em um relatrio, aps os totais para o campo de quebra especificado, consulte
Page (Pgina) na pgina 107.
Captulo 3
95
Descending (Decrescente)
Decrescente um modificador de campo que especifica a ordem de classificao para
campos-chave, incluindo campos calculados e expresses especficas. A opo Decrescente pode ser usada somente nos comandos Duplicidades, Falhas, ndice, Ordenar e
Seqncia.
A ordem de classificao-padro ascendente. Para obter mais informaes, consulte
Ascending (Crescente) na pgina 93.
96
Manual de Referncia
Captulo 3
97
executado mais uma vez quando for alcanado o final do arquivo, evitando a perda do
ltimo endereo.
ADDRESS1=ADDRESSMAIN
ADDRESS2=ADDRESSMAIN
ADDRESS3=ADDRESSMAIN
ADDRESS4=ADDRESSMAIN
COUNTER=0
GROUP IF ADDRESSMAIN=" "
EXTRACT ADDRESS1 ADDRESS2 ADDRESS3 ADDRESS4 TO OUT EOF
COUNTER=0
ELSE IF COUNTER=0
ADDRESS1=ADDRESSMAIN
ADDRESS2=" "
ADDRESS3=" "
ADDRESS4=" "
COUNTER=1
ELSE IF COUNTER=1
ADDRESS2=ADDRESSMAIN
COUNTER=2
ELSE IF COUNTER=2
ADDRESS3=ADDRESSMAIN
COUNTER=3
ELSE IF COUNTER=3
ADDRESS4=ADDRESSMAIN
COUNTER=4
END
98
Manual de Referncia
File (Arquivo)
Arquivo especifica que a sada de um comando deve ser salva em um arquivo separado.
Para obter mais informaes, consulte To (Para) na pgina 111.
Captulo 3
99
First (Primeiros)
Primeiros um parmetro de escopo que faz com que um comando seja executado
sobre um nmero consecutivo de registros, comeando com o registro 1. O processamento encerrado aps o nmero especificado de registros ter sido alcanado.
Primeiros no depende da posio atual do registro.
Aps a execuo de um comando que contm um parmetro Primeiros, a posio de
registro estabelecida no registro que segue imediatamente o nmero de registros
especificado no comando. Se o fim do arquivo for alcanado durante a execuo, a
posio de registro ser redefinida para o registro 1.
Primeiros tambm pode ser usado em conjunto com Se ou Enquanto. Aps a execuo
de um comando no qual tanto Primeiros como Enquanto estiverem especificados, a
posio de registro determinada pelo parmetro Enquanto.
No exemplo a seguir, First (Primeiros) faz com que o comando Total seja encerrado aps
10 registros:
TOTAL ALL FIRST 10
A posio do registro ser sempre 11, aps o comando acima ter sido executado,
qualquer que seja a posio no incio do comando.
100
Manual de Referncia
Footer (Rodap)
O boto Rodap usado para inserir um texto na parte inferior de cada pgina de um
relatrio. Isto ir ignorar qualquer valor definido por uma varivel de rodap.
Graph (Grfico)
A opo Grfico especifica que uma sada de um comando deve ser exibida em um
grfico. Grfico pode ser usado somente com os seguintes comandos: Benford, Classificar, Estratificar, Histograma e Perodo.
Captulo 3
101
Para obter mais informaes, consulte Sada para grfico na pgina 263 do
Guia do Usurio do ACL para Windows.
Header (Cabealho)
Cabealho usado para inserir um texto na parte superior de cada pgina de um
relatrio. Isto ignora qualquer valor definido por uma varivel de cabealho.
102
Manual de Referncia
If (Se)
Se um parmetro de escopo que faz com que um comando seja executado em registros
que satisfazem um determinado teste. Ele filtra todos os registros que falham no teste e
no depende da posio atual do registro.
Aps a execuo de um comando que contm uma clusula Se, a posio do registro
estabelecida no registro que segue imediatamente o nmero de registros especificado no
comando. Caso o fim do relatrio seja alcanado durante a execuo, a posio do
registro ser redefinida para o registro 1.
Se tambm pode ser usado em conjunto com Enquanto, Prximo ou Primeiros. Aps a
execuo de um comando no qual tanto Se como Enquanto estiverem especificados, a
posio do registro ser determinada pelo parmetro Enquanto.
Nota: Quando for aplicado um filtro global, a condio [Se] acrescentada ao, e no em
vez do, filtro.
Captulo 3
103
Key (Chave)
Chave especifica campos de quebra em um comando e faz com que dados de relatrio
sejam quebrados sempre que o valor do campo especificado for alterado. So gerados
subtotais para cada valor do campo de quebra. Chave tambm pode ser usado com uma
expresso que consiste em mais de um campo.
Campos-chave devem ser campos de caracteres. Para usar Quebra com um campo
numrico, converta-o em um campo de caractere usando a funo STRING( ).
Chave pode ser usado somente com os seguintes comandos: Classificar, Estratificar,
Histograma e Perodo.
Nota: Para obter resultados significativos, seu arquivo j deve ter sido ordenado ou
indexado no campo de Quebra especificado.
104
Manual de Referncia
Local
Este parmetro se aplica somente a arquivos processados usando o
Sistema ACL Cliente/Servidor. Local especifica que um arquivo de sada deve ser
gravado na unidade local ou do cliente. Quando Local assinalado, os comandos
gravam a sada na localizao do arquivo de projeto atual, a menos que seja fornecido
um caminho.
Name (Nome)
Nome usado para especificar o nome do arquivo de sada criado por um comando.
Captulo 3
105
Next (Prximo)
Prximo um parmetro de escopo que faz com que um comando seja executado sobre
um nmero de registros, comeando no registro atual. O processamento encerrado
depois de ter sido atingido um nmero especificado de registros. Prximo depende da
posio atual do registro.
Aps a execuo de um comando que contm um parmetro Prximo, a posio de
registro definida no registro que segue imediatamente o nmero de registros especificado no comando. Caso o fim do arquivo tenha sido alcanado durante a execuo, a
posio de registro ser redefinida para o registro 1.
Nota: Uma vez que Prximo faz com que o processamento seja encerrado antecipadamente, ele no pode ser usado em um grupo, apesar de poder ser usado no comando de
Grupo mais externo de um conjunto de grupos aninhados.
Prximo tambm pode ser usado em conjunto com o Se ou Enquanto. A clusula
Prximo aplicada primeiro, independentemente do teste Se. Caso Enquanto e
Prximo estejam especificados no mesmo comando, a posio do registro ser determinada pela primeira das duas clusulas a finalizar o processamento.
No exemplo a seguir, Next (Prximo) faz com que o comando seja finalizado aps 10
registros:
TOTAL ALL NEXT 10
106
Manual de Referncia
Captulo 3
107
Open (Abrir)
Abrir um parmetro de escopo usado para abrir um arquivo que tenha sido criado por
um comando. Se um arquivo de entrada j estiver aberto, o ACL fechar o arquivo antes
de executar o comando. O arquivo recm-criado usado como arquivo de entrada. Este
parmetro vlido apenas quando o comando cria um arquivo de sada.
Para obter mais informaes sobre o uso do parmetro Abrir como um comando,
consulte Open (Abrir) na pgina 240.
Page (Pgina)
Page (Pgina) um modificador de campo que insere uma quebra de pgina aps os
totais, para o campo-chave especificado.
Page pode ser usado somente no modo de comando.
Por exemplo, o comando a seguir produz um relatrio com dois nveis de subtotais: por
localizao e por classe de produto dentro da localizao. Aps cada linha de subtotal
por localizao, o relatrio continuar na parte superior de uma nova pgina.
REPORT ON Loc PAGE ProdCls ACCUMULATE QtyOH
Picture (Figura)
Figura um modificador de campo que especifica como formatar um campo de data ou
numrico. Figura pode ser usado somente no modo de comando. Para obter um equivalente de caixa de dilogo, consulte Campos numricos na pgina 157 do
108
Manual de Referncia
Por exemplo, o comando a seguir faz com que um arquivo de sada, Negfile, seja
produzido:
EXTRACT Value PIC "$9.999.999,99" IF Value < 0 TO "Negfile"
Print (Imprimir)
Imprimir especifica que a sada de um comando seja impressa.
Record (Registro)
Registro refere-se a um registro como uma unidade, sem referncia aos seus campos.
Registro especifica que o registro inteiro (esteja ou no definido) deve ser colocado no
arquivo de sada em vez de ser colocado apenas em campos selecionados. Isto significa
Captulo 3
109
que o arquivo de sada contm uma cpia exata do registro de entrada, incluindo toda e
qualquer definio de campo calculada.
Screen ( Tela)
A opo Tela especifica que a sada de um comando deve ser exibida no Log de comando
para reviso na tela.
110
Manual de Referncia
Suppress (Suprimir)
A opo Suprimir exclui quantidades fora de um intervalo de sada especificado.
Por exemplo, o comando Estratificar requer que os usurios especifiquem intervalos de
sada. Como padro, o comando analisa dois intervalos adicionais: o intervalo de
valores abaixo do mnimo especificado e o intervalo de valores acima do mximo
especificado. Suprimir ignora tal comportamento.
Suprimir tambm pode ser usado como modificador de campo, para suprimir a totalizao de campos numricos especficos, normalmente na sada para relatrio. Para
obter mais informaes, consulte Campos numricos na pgina 157 do
Guia do Usurio do ACL para Windows.
Captulo 3
111
To (Para)
Para usado para especificar o formato de sada de um comando. Dependendo do
comando, a sada pode ser:
Exibida na tela
Impressa
Exibida em um grfico
Salva em um arquivo
Para obter mais informaes, consulte Graph (Grfico) na pgina 100, Print
(Imprimir) na pgina 108 e Screen (Tela) na pgina 109.
112
Manual de Referncia
While (Enquanto)
Enquanto um parmetro de escopo que faz com que seja executado um comando
enquanto uma condio for verdadeira. O parmetro Enquanto faz com que o processamento de comandos seja encerrado assim que o teste especificado avalie a condio
como sendo falsa, ou quando for alcanado o fim do arquivo.
O parmetro Enquanto depende da posio atual do registro. Para iniciar o processamento, o registro atual deve ser avaliado como verdadeiro. Enquanto normalmente
usado com blocos de itens nos quais a condio avaliada como verdadeira.
Caso o fim do arquivo seja alcanado durante a execuo, a posio do registro ser
redefinida para registro 1.
Captulo 3
113
O parmetro Enquanto tambm pode ser usado em conjunto com Se, Prximo ou
Primeiros.
Aps a execuo de um comando que contm Enquanto e Se ou Primeiros, a posio do
registro determinada pelo parmetro Enquanto.
Aps a execuo de um comando no qual tanto Enquanto como Prximo estejam
especificados, a posio do registro ser determinada pela primeira das duas clusulas
que finalizam o processamento.
Nota: Como o parmetro Enquanto pode antecipar o encerramento de um processamento,
no pode ser especificado em um grupo (apesar de poder ser usado no prprio comando
Grupo mais externo).
Assim que o comando falhar no teste While (Enquanto), o processamento ser interrompido e a posio do registro, definida no primeiro registro que falhar no teste.
114
Manual de Referncia
Width (Largura)
Largura um modificador de campo que especifica a largura da exibio de um campo
ou expresso, especificados em um relatrio. A largura de exibio-padro o comprimento definido do campo. A utilizao do parmetro Largura ir substituir o padro.
Width (Largura) pode ser usada somente no modo de comando.
Para obter mais informaes, consulte Alterar largura da coluna na pgina 204 do
Guia do Usurio do ACL para Windows.
Captulo 4
C OMANDOS
Esta seo contm uma descrio completa de cada comando do ACL. A descrio do
comando inclui uma explicao da ao do comando e seus parmetros. Os exemplos
so fornecidos com propsitos ilustrativos.
Accept (Aceitar)
O comando Aceitar permite criar batches interativos que provocam uma pausa para a
exibio de uma caixa de dilogo solicitando informaes do usurio.
Este comando s pode ser executado no modo de comando. No pode ser usado em um
comando Grupo. aconselhvel colocar todos os comandos Aceitar no incio de um
batch.
Use Aceitar para criar batches que solicitam informaes do usurio, tais como intervalos de amostragem, nomes de arquivos, nmeros de departamentos ou cabealhos e
rodaps de relatrio.
O ACL armazena as entradas do usurio em uma varivel de caractere. Quando a
entrada do usurio for um valor numrico necessrio para um comando ACL subseqente, o comando interpreta a entrada do usurio como um valor de caractere. Voc
pode precisar converter os dados do caractere em uma varivel para formato numrico
ou de data, antes de us-lo em outras operaes.
Para usar o contedo literal de uma varivel em um comando ou operao subseqente,
voc pode fazer referncia varivel pelo nome. Para que o ACL interprete o contedo
de uma varivel como sendo o nome de um campo ou arquivo, use o caractere de
porcentagem (%) antes e aps o nome da varivel. Isso converte o nome da varivel em
uma macro e instrui o ACL a adotar o contedo da varivel como referncia para um
campo ou arquivo nomeado.
Para obter mais informaes, consulte Variveis na pgina 343 do Guia do Usurio do
ACL para Windows, Batches interativos na pgina 341 do Guia do Usurio do
ACL para Windows, e Macro de substituio na pgina 349 do Guia do Usurio do
ACL para Windows.
Para criar caixas de dilogo mais complexas, use o comando Dilogo. Para obter mais
informaes, consulte Dialog (Dilogo) na pgina 151.
115
116
Manual de Referncia
Parmetros
O comando Accept (Aceitar) tem os seguintes parmetros: Fields (Campos), To (Para).
Fields (Campos)
Permite o uso de listas suspensas ao invs de caixas de texto para a entrada do usurio.
Listas suspensas podem conter um ou mais tipos de campo.
To (Para)
Atribui a resposta do usurio a uma varivel de caractere nomeada.
Captulo 4
Comandos
Accept (Aceitar)
117
usurio durante a execuo do batch. A cadeia de solicitaes deve estar entre aspas e
deve ser curta.
nome_da_varivel especifica o nome da varivel de caractere que armazena a
Nota: No misture itens xixrxbxfxw com itens CcNnLlDd. Voc no deve ter tipos de
item de Projeto na mesma lista com nomes de campo ou nomes de variveis. Isso pode
resultar em escolhas inadequadas do usurio, que causam erros de processamento.
Campos de caractere
Variveis de caractere
Campos numricos
Variveis numricas
Variveis lgicas
Campos de data
Variveis de data
xb
Batches
xf
Arquivos de entrada
xi
ndices
xr
Exibies e relatrios
xw
reas de trabalho
118
Manual de Referncia
Quando voc executa o batch, a primeira caixa de dilogo exibida solicitando o nome
do arquivo.
A segunda caixa de dilogo solicita o nome do campo a ser amostrado. A sintaxe para
esta solicitao, mostrada na terceira linha de comando acima, usa a palavra-chave
FIELDS 'N'. Como resultado, essa caixa de dilogo contm uma lista suspensa dos
campos numricos disponveis.
Captulo 4
Comandos
Accept (Aceitar)
119
O ACL exibe o resultado do batch no Log de comando. Observe que o ACL avalia a
macro %FILENAME% na linha dois do batch e abre o arquivo Inventory.
O Log de comando mostra que os registros foram extrados para um arquivo chamado
Inventory_sample. Para exibir os registros amostrados, selecione Inventory_sample na
caixa de dilogo Selecionar Arquivo de Entrada.
120
Manual de Referncia
O comando Accept acima produz uma caixa de dilogo com uma lista suspensa de
nomes de campos e duas caixas de texto.
Activate (Ativar)
Ativar usado somente para reas de trabalho. O comando Ativar usado quando voc
tem um conjunto de campos armazenados em uma rea de Trabalho que so usados
com vrios arquivos de entrada.
Este comando s pode ser executado no modo de comando. Para obter mais informaes, consulte Emitir comandos na pgina 267 do Guia do Usurio do
ACL para Windows.
Por exemplo, Ativar permite usar campos calculados durante a utilizao de um arquivo
dBASE. Alm disso, ao trabalhar com arquivos de vrios tipos de registros, voc pode
armazenar a definio referente a cada tipo de registro em uma rea de trabalho
separada. Se voc pretende trabalhar com poucos tipos de cada vez, pode ativar as reas
de trabalho apropriadas.
O comando Ativar traz todos os campos da rea de Trabalho especificada para o
ambiente atual, somente para a sesso em curso. Para tornar as definies ativadas uma
parte permanente da definio de arquivo de entrada, use o comando Salvar antes que
um novo arquivo seja aberto, ou antes que a sesso seja terminada.
O comando Ativar adiciona temporariamente um conjunto de definies de campo,
contido em uma rea de trabalho, ao conjunto de campos existente para o arquivo de
Captulo 4
Comandos
Activate (Ativar)
121
entrada atual. Para obter mais informaes, consulte Ativar reas de trabalho na
pgina 357 do Guia do Usurio do ACL para Windows.
Nota: Quando voc altera campos da rea de trabalho ativa, os campos so salvos
automaticamente com o arquivo de entrada.
Para usar o comando Ativar importante conhecer como funcionam as reas de
trabalho. Para obter mais informaes, consulte Save (Salvar) na pgina 290 e reas
de trabalho na pgina 355 do Guia do Usurio do ACL para Windows.
Parmetros
O comando Activate (Ativar) tem os seguintes parmetros: OK, Workspace (rea de
trabalho).
OK
Indica que um campo do arquivo de entrada com um nome idntico a um campo da
rea de trabalho ativa ser substitudo (sobrescrito) sem confirmao. No possvel
substituir um campo referenciado por um campo calculado.
Padro: Confirmar antes de substituir um campo.
Exemplo
Este exemplo usa o comando Activate (Ativar) para ativar uma rea de trabalho,
Inventory-margin (margem de estoque), contendo campos calculados que calculam as
margens unitrias e margens em percentuais unitrios para itens de um arquivo de
estoque.
Para exibir o contedo do arquivo antes de ativar a rea de trabalho, digite DISPLAY na
caixa de texto do Log de comando.
O ACL exibe o contedo do arquivo na janela Log de comando.
122
Manual de Referncia
Para ativar a rea de trabalho usando o comando Activate, digite o seguinte na caixa de
texto do Log de comando:
ACTIVATE WORKSPACE INVENTORY_MARGIN
Reemita o comando Display (Exibir) para revelar o contedo do arquivo, aps ativar
Inventory_margin, e v at a parte inferior da janela. Os dois campos ativados, Loc05 e
City (Cidade), aparecem como os dois ltimos campos da exibio.
Captulo 4
Comandos
Age (Perodo)
123
Age (Perodo)
Use o comando Perodo para produzir resumos de dados por perodos. Os exemplos
incluem avaliao de tendncias de vendas, observao de volumes de transaes e a
classificao de faturas pelo nmero de dias a vencer a partir de uma data em particular.
A menos que voc especifique uma data limite, o perodo baseado na data atual do
sistema.
Voc pode especificar pontos de partida tais como 0, 90, 120 e assim por diante, para
cada perodo de vencimento, ou pode aceitar as definies padro de 0, 30, 60, 90, 120,
e 10.000 dias.
O nmero de registros em cada perodo exibido no Log de comando em uma coluna
gerada pelo ACL, intitulada COUNT, visualizada no Exemplo na pgina 125. Voc
pode tambm acumular a totalizao dos campos numricos para cada perodo.
Parmetros
Alm dos parmetros descritos abaixo, o comando Age (Perodo) tem os seguintes
parmetros: All (Tudo), Append (Anexar a um arquivo existente), Break (Quebra), File
(Arquivo), File Type (Tipo de arquivo), First (Primeiros), Footer (Rodap), Graph
(Grfico), Header (Cabealho), If (Se), Local (Local), Name (Nome), Next (Prximo),
Print (Imprimir), Screen (Tela), Suppress (Suprimir outros), While (Enquanto). Para
obter a descrio desses parmetros, consulte o Captulo 3: Definir arquivos e
campos.
124
Manual de Referncia
As definies padro so 0, 30, 60, 90, 120, 10.000 dias. Esses padres so definidos na
caixa de dilogo Editar preferncias do ACL. Para informaes sobre alteraes desses
padres, consulte Perodos na pgina 324 do Guia do Usurio do ACL para Windows.
Sada do comando
A sada do Log de comando para esse comando tem colunas para intervalos de vencimento, o nmero de registros em cada intervalo e o percentual do total de registros
representado para cada um dos intervalos. Se um ou mais campos foram acumulados,
colunas adicionais so exibidas: outra coluna de percentual e os totais acumulados dos
campos para cada classificao.
Captulo 4
Comandos
Age (Perodo)
125
Cada coluna de percentual aponta para a coluna que ela representa. A coluna de
percentual localizada direita aponta para a coluna de campo acumulado mais prxima
e exibe o percentual do valor total representado pelo valor desse intervalo. Os percentuais no so fornecidos para colunas adicionais de campos acumulados.
Datas anteriores data limite caem em um dos perodos de vencimento especificados. O
ACL cria outro perodo <0, para datas mais recentes que a data limite.
Exemplo
Analise os registros em um arquivo de contas a receber, para determinar o nmero e
valor dos registros entre 30 a 59 dias aps a data do vencimento. Disponha os registros
de acordo com um campo data de vencimento e acumule em um campo de valores
devidos, usando 13 de novembro de 2000 como data limite. Use as definies padro
para os perodos de vencimento.
1. Com o arquivo Ar aberto, clique em [Perodo] na barra de botes, ou selecione
Analisar na barra de menus e escolha Perodo para exibir a caixa de dilogo
Perodo.
2. Selecione o campo Due (Vencimento) a partir da lista suspensa Perodo em.
Voc tambm pode clicar em [Perodo em] para exibir a caixa de dilogo Campos
selecionados, que fornece mais informaes sobre os campos que voc est selecionando.
126
Manual de Referncia
ou
H trs formas para selecionar campos usando a caixa de dilogo Campos selecionados:
Selecione o campo Due na lista e clique em [OK] para retornar caixa de dilogo
Perodo.
3. Especifique a data limite. Clique na seta na lista suspensa Data limite para exibir o
calendrio a partir do qual voc pode selecionar sua data limite. Ento, clique nas
setas, no ms ou no ano para selecionar outra data.
Captulo 4
Comandos
Age (Perodo)
127
128
Manual de Referncia
Assign (Atribuir)
Voc pode usar o comando Atribuir para armazenar um valor como uma varivel.
Tambm pode anexar uma condio ao comando Atribuir.
O comando Atribuir geralmente usado em um batch no qual se deseja alterar o valor
de uma varivel. Se o comando Atribuir for emitido sem uma condio, a atribuio
ocorre automaticamente.
O comando Atribuir pode ser usado como um comando separado ou num grupo. Um
comando Atribuir em um grupo executa a atribuio, toda vez em que o comando
encontrado, se o teste resultar em verdadeiro para aquele registro ao menos uma vez por
registro.
Se voc atribuir um valor a um nome de varivel existente e a varivel estiver sendo
usada em um campo calculado ou a atribuio for feita em um grupo, o valor atribudo
ajustado para as especificaes previamente definidas para aquela varivel; o comprimento preenchido ou truncado, e os decimais so ajustados, se necessrio.
Se voc atribuir um valor para o nome de uma varivel existente e a varivel no estiver
sendo usada em um campo calculado ou for atribuda fora de um grupo, o valor anterior
e suas especificaes so substitudos.
Captulo 4
Comandos
Assign (Atribuir)
129
Parmetros
O comando Assign (Atribuir) tem o seguinte parmetro: If (Se). Para obter uma
descrio, consulte Captulo 3: Parmetros de comandos comuns.
atribuio no ACL.
nome-da-varivel = expresso interpretada automaticamente como uma
atribuio.
nome-da-varivel especifica o nome da varivel a ser criada. Todas as convenes
Exemplo 1
Tome o valor da classe do produto para ao registro atual e o atribua a uma varivel
denominada MPRODCLS.
Digite MPRODCLS = PRODCLS na caixa de texto do Log de comando.
Como MPRODCLS uma varivel, seu valor no ir se alterar a menos que seja explicitamente alterado por outro comando Atribuir.
130
Manual de Referncia
Exemplo 2
Use o seguinte comando em um batch para atribuir o valor l varivel SAMPLE_QTY,
sempre que MCOUNT for menor que 10:
SAMPLE_QTY = 1 IF MCOUNT < 10
Se MCOUNT for maior ou igual a 10, nenhuma ao tomada pelo ACL. Isso significa
que o valor de SAMPLE_QTY permanece inalterado. Se a varivel no existia anteriormente, no ser criada.
Benford
O comando Benford permite que voc gere anlise digital usando a frmula de Benford.
Esse comando conta o nmero de vezes que cada dgito ou combinao de dgitos
esquerda ocorre, em um conjunto de dados, e compara o resultado real ao resultado
esperado. O resultado esperado calculado usando a frmula de Benford. O comando
de sada pode ser enviado para um grfico.
Para ajud-lo a avaliar o significado dos desvios entre as contagens real e esperada, o
comando de sada inclui a estatstica-Z para cada uma. Voc pode tambm usar a opo
Limites para ajud-lo a identificar freqncias de dgitos que estejam fora das expectativas de forma significativa. Quando mais de uma coluna de resultado fica fora dos
limites, os dados representados por essas colunas podem ser anmalos.
Para obter mais informaes sobre anlise digital, consulte Digital Analysis Using
Benfords Law: Tests & Statistics for Auditors, de Mark J. Nigrini, Ph.D., publicado pela
Global Audit Publications.
Nota: As ferramentas de anlise digital como o comando Benford permitem que auditores
e outros analistas de dados se concentrem em possveis anomalias, em conjuntos de dados
volumosos. Elas no provam a existncia de um erro ou fraude, mas identificam itens que
merecem estudo posterior, com base em fundamentos estatsticos. A anlise digital complementa as ferramentas e tcnicas analticas existentes, e no deve ser usada isoladamente
delas.
Parmetros
Alm dos parmetros descritos abaixo, o comando Benford tem os seguintes
parmetros: All (Tudo), Append (Anexar a um arquivo existente), Break (Quebra), File
(Arquivo), File Type (Tipo de arquivo), First (Primeiros), Footer (Rodap), Graph
(Grfico), Header (Cabealho), If (Se), Name (Nome), Next (Prximo), Print
(Imprimir), Screen (Tela), Use Output File (Usar arquivo de sada), While (Enquanto).
Captulo 4
Comandos
Benford
131
Entrada
Esse comando analisa campos numricos. Voc pode especificar at seis Dgitos
anteriores (Iniciais) a serem analisados. Quando h mais de trs Dgitos iniciais, a
anlise Benford precisa ser enviada para um arquivo. A anlise de cinco ou mais Dgitos
iniciais leva tempo e o ACL avisa no Log de comando que est executando. Use a tecla
ESC para interromper o comando a qualquer tempo, antes dos resultados aparecerem no
Log de comando.
Uma anlise Benford eficaz requer amostras de tamanho grande. O ACL previne
quando um tamanho de amostra pode ser muito pequeno para o nmero de dgitos
especificado.
Dados anmalos aparecem melhor quando voc analisa valores positivos e negativos
separadamente. Voc pode usar um filtro para separar os dois valores, antes de comear
a anlise. Dgitos ou combinaes de dgitos com valores iguais a zero so automaticamente excludos.
132
Manual de Referncia
O comando Benford ignora registros com valores iguais a zero, mas relata o nmero de
registros de valor zero ignorados. Tambm ignora zeros esquerda, formatao
numrica como decimais e sinais de cifro e outros dgitos no numricos. Se o nmero
resultante de dgitos for menor que o especificado, o ACL adiciona zeros direita do
resultado.
Sada
A sada padro um arquivo de dados do ACL, em formato de tabela. Voc tambm
pode enviar a sada para um grfico de linhas ou para um grfico de barras em 2-D.
Sada em tabela
A tabela contm quatro colunas: Dgitos anteriores, Contagem real, Contagem esperada
e Zstat razo. Se selecionar a opo limites, a tabela conter duas colunas adicionais,
Limite superior e inferior.
Nenhuma sada produzida para registros que deixam de atender os critrios de teste ou
para registros que contm somente zeros.
A coluna de Dgitos anteriores mostra os dgitos iniciais testados. Por exemplo, se voc
especificar um dgito inicial, Dgitos anteriores exibe os nmeros de 1 a 9. Se voc
especificar dois dgitos iniciais, Dgitos anteriores exibe os nmeros de 10 a 99.
A coluna Contagem real mostra a contagem de cada dgito inicial ou a combinao de
dgitos iniciais encontrada na populao.
A coluna Contagem esperada mostra o valor calculado de acordo com a frmula de
Benford.
A coluna Zstat razo exibe a estatstica-Z para cada combinao de dgitos. Consulte
ZSTAT( ) na pgina 88.
Sada em grfico
O grfico mostra a contagem real, o valor Benford esperado e os limites superior e
inferior, se a caixa Incluir Limite superior e inferior na guia [Principal] estiver
assinalada. A anlise de um nico dgito inicial produz 9 pontos de dados no eixo x, a de
dois dgitos iniciais produz 90 pontos, a de trs dgitos iniciais produz 900 pontos e
assim por diante.
Voc pode tambm clicar duas vezes em <<<Dados de grfico>>> no Log de
comando para exibir o grfico.
Captulo 4
Comandos
Benford
133
Exemplo
BENFORD ON Amount LEADING 2 BOUNDS TO SCREEN
134
Manual de Referncia
Calculate (Calcular)
O comando Calcular calcula e exibe o valor de uma expresso.
Este comando s pode ser executado no modo de comando. Para obter mais informaes, consulte Usar comandos na pgina 260 do Guia do Usurio do
ACL para Windows.
O resultado de Calcular pode ser um valor de caractere, lgico, numrico ou de data.
Para efetuar vrios clculos ao mesmo tempo, separe as expresses a serem avaliadas
por vrgulas.
Captulo 4
Comandos
Calculate (Calcular)
135
Pr-requisitos
Se a expresso contm um valor de campo de um arquivo de entrada, o arquivo de
entrada apropriado deve ser aberto. Use os comandos Localizar, Encontrar ou Buscar
para mover o registro a ser analisado por Calcular. Para mais informaes, consulte
Find (Localizar) na pgina 195, Seek (Encontrar) na pgina 297, e Search
(Pesquisar) na pgina 291.
Parmetros
O comando Calculate (Calcular) tem o seguinte parmetro: As (Como). Para obter uma
descrio, consulte o Captulo 3: Parmetros de comandos comuns.
Exemplo 1
Para multiplicar 4,7 por 18,5 rapidamente usando o ACL, digite CALC 4,7*18,5 na
caixa de texto do Log de comando.
136
Manual de Referncia
Clique em
(Aceitar Entrada) ou pressione ENTER para calcular o resultado. Escolha
ltimo resultado na lista suspensa do Log de comando para exibir o resultado.
Nota: O ACL arredonda o resultado de 86,95 para 87,0.
Consulte Aritmtica de ponto fixo na pgina 284 do Guia do Usurio do
ACL para Windows para obter mais detalhes.
Exemplo 2
Calcule a margem bruta e o percentual da margem bruta para o registro atual. Usando
campos previamente definidos para o preo de venda e custo unitrio, calcule a margem
de lucro bruta e o percentual da margem bruta por unidade, para o registro atual.
Nomeie os resultados apropriadamente e, a seguir, digite CALCULATE SALEPR-UNCST
AS 'MARGIN' na caixa de texto do Log de comando.
Selecione ltimo resultado na lista suspensa do Log de comandos, para exibir o
resultado.
Classify (Classificar)
Use o comando Classificar para contar o nmero de registros relativos a cada valor
nico de um campo de caractere e para acumular totais de campos numricos especificados para cada um desses valores nicos.
O nmero de registros para cada valor exibido em um campo gerado pelo ACL,
denominado COUNT. O limite no nmero de totais depende da RAM disponvel em
seu computador, mas normalmente de 50.000 ou mais. H cerca de 20.000 totais por
megabyte, conforme configurado pela preferncia RAM Mx(MB).
Captulo 4
Comandos
Classify (Classificar)
137
Parmetros
Alm dos parmetros descritos abaixo, o comando Classify (Classificar) tem os
seguintes parmetros: All (Tudo), Append (Anexar a um arquivo existente), Break
(Quebra), File (Arquivo), File Type (Tipo de arquivo), First (Primeiros), Footer
(Rodap), Graph (Grfico), Header (Cabealho), If (Se), Local (Local), Name (Nome),
Next (Prximo), Print (Imprimir), Screen (Tela), Use Output File (Usar arquivo de
sada), While (Enquanto). Para uma descrio desses parmetros, consulte o
Captulo 3: Parmetros de comandos comuns.
Sada do comando
A sada no Log de comando para esse comando tem colunas para o nome da classificao, o nmero de registros em cada classificao e o percentual do total de registros
que cada classificao representa. Se um ou mais campos forem acumulados, sero
138
Manual de Referncia
Exemplo
Para classificar um arquivo de transao de vendas de acordo com o nmero do
produto, use o comando Classificar. Voc pode fazer isso a fim de determinar quais
produtos so lderes de venda e quais esto potencialmente obsoletos.
Nota: O comando Classificar no exige que os dados estejam ordenados.
Acumule campos referentes quantidade disponvel e ao valor da transao e envie a
sada para um arquivo denominado Prodsale.
Captulo 4
Comandos
Classify (Classificar)
139
140
Manual de Referncia
Close (Fechar)
O comando Fechar fecha um arquivo de entrada aberto e equivale a clicar no boto
(Fechar) da janela Viso geral ou clicar em [Nenhum] na caixa de dilogo Selecionar
arquivo de entrada. Consulte Caixas de dilogo selecionar/editar na pgina 40 do
Guia do Usurio do ACL para Windows para obter detalhes.
Este comando s pode ser executado no modo de comando. Para obter mais informaes, consulte Emitir comandos na pgina 267 do Guia do Usurio do
ACL para Windows.
Voc no precisa fechar um arquivo de entrada para abrir outro. O ACL fecha automaticamente um arquivo de entrada antes de abrir outro. O arquivo a ser fechado pode ser
descrito de acordo com o tipo (primrio ou secundrio) ou pelo nome. Se nenhum
parmetro for especificado, o arquivo primrio ser fechado. Se voc estiver fechando
um arquivo de entrada primrio ou secundrio, o ACL ir remover todas as definies
de campo correspondentes do ambiente atual. Todas as alteraes feitas em definies
de registro so salvas antes do fechamento do arquivo. O ACL ir fechar automaticamente o arquivo de entrada, antes de executar os comandos Open (Abrir) e Quit (Sair).
Se voc tiver definido relacionamentos em seu Projeto ACL, o comando Fechar ir
fechar o arquivo primrio e todos os arquivos secundrios, alm dos arquivos relacionados.
Se voc estiver fechando um arquivo LEARN, o comando Fechar ir operar da mesma
maneira que a configurao Set Learn Off (Desativar Learn). Set Learn On/Off
(Ativar/Desativar Learn) e Open/Close Learn (Abrir/Fechar Learn) equivalem a
selecionar o menu Ferramentas e Ativar/Desativar o gravador de batch.
Nota: Voc no pode usar o comando Fechar para fechar um projeto ACL.
Para obter maiores informaes sobre como utilizar o Gravador de Batch, consulte
Criar batches na pgina 334 do Guia do Usurio do ACL para Windows.
Captulo 4
Comandos
Comment (Comentrio)
141
Exemplo
Para abrir e fechar o arquivo primrio de contas a receber de nome Ar sem abrir um
arquivo diferente, digite CLOSE PRIMARY na caixa de texto do Log de comando.
A barra de status indicar que nenhum arquivo de entrada est aberto.
Comment (Comentrio)
Use o comando Comentrio para inserir uma observao ou explicao no arquivo de
Log do ACL sem afetar o processamento ou a execuo. O comando Comentrio
permite que voc documente uma sesso, incluindo itens como objetivos, descries e
outras explicaes necessrias. Voc pode usar Comentrio em batches ou grupos, para
incluir comentrios no Log.
Esse um mtodo eficiente para incluir documentao adequada, a fim de ajudar os
futuros usurios a determinar as operaes executadas e os resultados obtidos.
Quando no fizerem parte de um batch ou grupo, as linhas de comentrios so registradas no Log no momento em que so digitadas. Em um batch ou grupo, os comentrios so registrados como parte do arquivo de batch. Eles so includos no arquivo de
Log no momento em que o batch executado e exibidos no lugar apropriado dos resultados.
142
Manual de Referncia
ou
COMMENT
linha de comentrio
linha de comentrio
...
linha de comentrio permite que voc digite um texto em um arquivo de log, em
um batch ou grupo.
Ao incluir mais que uma linha de comentrio, voc dever inserir uma linha em branco
aps a ltima linha de comentrio, para indicar que aquela a ltima linha de comentrio. Se voc no deixar uma linha em branco, o ACL ir considerar as linhas seguintes
como comentrios.
Exemplo
No ponto apropriado de um batch criado para fornecer uma viso geral bsica do
estoque antes de uma contagem de estoque, digite o seguinte na caixa de texto Comentrio:
TODOS OS VALORES NEGATIVOS REFERENTES QUANTIDADE
DISPONVEL DEVEM SER DISCUTIDOS COM O CONTROLADOR.
Captulo 4
Comandos
Count (Contar)
143
Count (Contar)
Use o comando Contar para contar o nmero de registros no arquivo de entrada atual
ou somente aqueles que atendem a uma condio de teste especfica.
Se nenhum teste for especificado, ser exibido o nmero total de registros do arquivo de
entrada. Se um filtro global tiver sido aplicado a uma exibio, o comando Contar ir
produzir o nmero de registros restantes no arquivo, aps ter sido aplicada a condio
do filtro.
O nmero total de registros existentes em um arquivo ou o nmero de registros correspondentes ao filtro global atual exibido no centro da barra de status.
O comando Contar armazena automaticamente seu resultado na varivel denominada
COUNTn (por exemplo, COUNT1). Quando o comando Contar for emitido como
parte de um grupo, o nmero de comando seqencial usado no nome da varivel n.
Por exemplo, se Contar o sexto comando no grupo, a varivel resultante nomeada
como COUNT6.
Parmetros
O comando Count (Contar) tem os seguintes parmetros: All (Tudo), First (Primeiros),
If (Se), Next (Prximo), While (Enquanto). Para a descrio desses parmetros,
consulte o Captulo 3: Parmetros de comandos comuns.
144
Manual de Referncia
Exemplo
Para contar o nmero de itens que possuem um valor registrado superior ao valor
estabelecido, digamos $15.000, use o comando Contar. Voc pode executar esse teste
para determinar o nmero de itens de estoque com um custo registrado que exceda um
valor predeterminado, como a materialidade ou preciso monetria. Voc pode
verificar fisicamente a existncia desses itens como parte de seus procedimentos gerais
de controle ou verificao do estoque.
Se, para verificar a preciso do sistema de contabilidade, todos os itens de estoque que
custam mais que $15.000 devem ser contados, ento devero ser realizados 10 testes.
Use Extrair com a mesma condio para armazenar esses registros em um arquivo
separado. Para obter mais informaes, consulte Extract (Extrair) na pgina 186.
Captulo 4
Comandos
Define Field (Definir campo)
145
Os campos podem conter tipos de dados sobrepostos. Por exemplo, voc pode definir
os bytes de 1 a 10 como um tipo de dado numrico. Voc pode em seguida definir a
mesma rea, ou parte dela, por exemplo, os bytes de 5 a 9, como um tipo de dado ASCII.
Nota: Para obter uma maneira mais direta e conveniente de definir campos, utilize a
janela Definio de arquivo de entrada, conforme descrito em Definir campos de dados
fsicos na pgina 155 do Guia do Usurio do ACL para Windows e Campos calculados
na pgina 160 do Guia do Usurio do ACL para Windows. Use essas tcnicas sempre que
possvel.
Parmetros
Alm do parmetro descrito abaixo, o comando Define Field (Definir) campos tem os
seguintes parmetros: As (Como), If (Se), Picture (Figura), Width (Largura). Para obter
uma descrio desses parmetros, consulte o Captulo 3: Parmetros de comandos
comuns.
Computed (Calculado)
Identifica o campo que est sendo definido como um campo calculado.
Campos calculados
Voc pode definir campos calculados simples somente em um batch. Um exemplo de
campo calculado simples :
DEFINE FIELD VALOR COMPUTED CUSTO*QUANTIDADE
Isso define um novo campo Valor, para que seja o produto do campo Custo multiplicado
pelo campo Quantidade.
A sintaxe para campos calculados requer parmetros a serem digitados em linhas
mltiplas. Uma vez que a linha de comando no suporta comandos de linhas mltiplas,
voc precisa usar esse comando no modo batch para criar campos calculados.
Nos exemplos abaixo, o smbolo de retorno de carro () marca o final de cada linha de
um texto de linhas mltiplas. No digite um retorno de carro, exceto quando indicado
146
Manual de Referncia
pelo smbolo de retorno de carro. Se voc informar um retorno de carro antes do final
da linha, o comando no ir funcionar.
Campo calculado incondicional
Por exemplo, voc pode usar a seguinte sintaxe de campo calculado condicional para
substituir as abreviaes de estado por nomes de estado:
DEFINE FIELD nome-de-estado COMPUTED
culos, incluindo o caractere sublinhado (_). Para criar um nome de duas palavras,
preencha o espao entre as palavras com um caractere de sublinhado ou outro. Ao
nomear campos a partir de uma caixa de dilogo, o ACL insere automaticamente o
caractere de sublinhado entre as palavras.
tipo-do-campo identifica o tipo de campo apropriado. Consulte o Captulo 1: Tipos
de campo.
posio-inicial identifica a primeira posio do byte contando a partir de 1 e indo
sendo definido.
decimais aplica-se somente a campos numricos. Identifica o nmero de casas
decimais direita de qualquer vrgula decimal.
Captulo 4
Comandos
Define Field (Definir campo)
147
Exemplo
Para definir um campo ASCII contendo nmeros de faturas chamados Invnum com
uma posio de incio no byte 1 e comprimento de 6 bytes:
1. Digite essa sintaxe na caixa de texto do Log de comando:
DEFINE FIELD Invnum ASCII 1 6
2. Pressione ENTER.
3. Voc pode verificar que o ACL definiu o campo ao selecionar Editar na barra de
menus e selecionando Definio de arquivo de entrada para exibir a janela
Definio de arquivo de entrada. A guia [Editar campos/expresses] relaciona o
campo recm-definido.
4. Selecione o campo, em seguida clique duas vezes nele para obter mais informaes
sobre o novo campo. A janela muda para mostrar o nome, tipo, posio inicial e
comprimento do campo definido. Os bytes que o campo ocupa tambm so destacados.
148
Manual de Referncia
Aps fechar a janela Definio de arquivo de entrada, voc pode adicionar o campo
definido exibio, clicando em
(Adicionar colunas) para exibir a caixa de dilogo
Adicionar colunas. Para obter mais informaes sobre a adio de campos a exibies,
consulte Adicionar uma coluna a uma exibio na pgina 202 do Guia do Usurio do
ACL para Windows.
Captulo 4
Comandos
Delete (Excluir)
149
nova exibio com o nome especificado. Se voc der exibio um nome composto com
duas palavras, certifique-se de incluir o caractere de sublinhado entre as mesmas.
Delete (Excluir)
Use o comando Excluir para remover arquivos, campos ou variveis indesejados do
ambiente ACL atual. Voc tambm pode usar o comando Excluir para excluir um
arquivo de dados. Por exemplo, DELETE TEMP.FIL.
Este comando s pode ser executado no modo de comandos. Para obter mais informaes, consulte Emitir comandos na pgina 267 do Guia do Usurio do
ACL para Windows.
O item especificado removido onde estiver armazenado, por exemplo, no
Projeto ACL, em uma unidade local ou em uma unidade de rede, e se no est mais
acessvel. Voc no pode excluir um campo ou varivel ao qual um campo calculado faz
refe- rncia, a menos que exclua primeiro o campo calculado. Alm disso, voc no
pode excluir um campo ao qual a exibio atual faz referncia.
A menos que especifique OK na linha de comando, voc ser solicitado a confirmar a
excluso de qualquer item. Haver uma solicitao de confirmao mesmo que a opo
Avisar antes de substituir arquivos na guia [Opes de interface] das Preferncias no
estiver selecionada.
150
Manual de Referncia
Voc pode usar Excluir no batch ou no Log de comando com qualquer palavra-chave
exibida a seguir.
Parmetros
O comando Delete (Excluir) tem os seguintes parmetros: All (Tudo), History
(Histrico), OK.
All (Tudo)
Indica que todas as variveis do ambiente ACL atual devem ser excludas. Os campos
no so afetados.
History (Histrico)
Exclui histricos do arquivo aberto no momento. Para salvar os histricos de um
arquivo de entrada existente antes de exclu-los, use o comando Display History. Voc
escolhe entre selecionar os histricos de arquivo e imprimi-los, ou copi-los e col-los
em um arquivo de texto. Se voc excluir o histrico de um arquivo de entrada, no pode
usar sua exibio para recriar o batch inteiro com a opo Criar batch a partir do
histrico do arquivo, em Ferramentas, na barra de menus. Entretanto, voc pode recriar
aquela poro do batch para a qual o histrico permanece.
OK
Indica que o comando dever ser executado sem confirmao.
{nome-do-campo|nome-da-varivel|nome-do-arquivo|ALL}
HISTORY <nmero-a-ser-mantido>
RELATION <OK>
BATCH <nome-do-batch>
FORMAT <nome-da-definio-do-arquivo-de-entrada>
REPORT <nome-da-exibio>
WORKSPACE <nome-da-rea-de-trabalho>
INDEX <nome-do-ndice >
Captulo 4
Comandos
Dialog (Dilogo)
151
Exemplo 1
Para excluir um campo (QTYOO) contendo a quantidade dos itens de estoque no
pedido, digite DELETE QTYOO na caixa de texto do Log de comando.
O ACL exibe uma caixa de dilogo solicitando que voc confirme que deseja excluir o
campo.
Exemplo 2
Este batch executa um processamento cclico em um arquivo de entrada denominado
Demo e, por fim, executa o comando Delete History (Excluir histrico), retendo os
quatro ltimos histricos criados (aqueles criados no ltimo ciclo).
O smbolo retorno de carro () marca o final de cada linha do texto de mltiplas linhas.
OPEN DEMO
SORT ON PRODCLS PRODNO TO "SORTPROD"
OPEN SORTPROD
EXTRACT RECORD TO "SORTED" IF AMOUNT > 100
OPEN SORTED
EXTRACT ON COST ACCUMULATE MKTVAL PROFIT INTERVAL 10 TO
"STRATCOST"
OPEN STRATCOST
EXTRACT RECORD TO DEMO IF AMOUNT > 0
OPEN DEMO
DELETE HISTORY 4
Dialog (Dilogo)
Use o comando Dilogo para criar uma caixa de dilogo personalizada para interao
com o usurio em um batch. As caixas de dilogo personalizadas controlam o modo
como um batch executado, solicitando entradas e selees ao usurio. Onde for
possvel, coloque as caixas de dilogo no incio de um batch, de modo que os passos
restantes do batch possam prosseguir sem mais interrupes.
152
Manual de Referncia
Antes de usar o comando Dilogo ou o Construtor de dilogos, voc deve planejar seu
batch e ter um slido conhecimento de suas anlises e arquivos. Voc pode levar em
considerao as seguintes perguntas antes de iniciar:
Reserve alguns momentos para pensar sobre seus objetivos e determinar o que voc
deseja que as caixas de dilogo em seu batch faam. Uma abordagem excelente
desenhar o fluxo do batch antes de comear a constru-lo. Isso permite que voc se
concentre primeiro no funcionamento do batch e, em seguida, na interface para o
usurio.
Para obter mais informaes, consulte Batches na pgina 261 do Guia do Usurio do
ACL para Windows e Batches interativos na pgina 341 do Guia do Usurio do
ACL para Windows.
Construtor de dilogos
O Construtor de dilogos d acesso a todos os recursos do comando Dilogo. Ao usar o
Construtor de dilogos, voc pode estruturar caixas de dilogo personalizadas usando a
interface grfica. Ele oferece flexibilidade e controle para criar caixas de dilogo bastante
sofisticadas e personalizadas, que melhor se ajustem s suas necessidades. Voc pode
obter rapidamente uma vasta gama de informaes usando uma caixa de dilogo personalizada. Para fazer uso completo do Construtor de dilogos, voc deve estar familiarizado com os conceitos no Captulo 8: Automatizar o ACL no Guia do Usurio do
ACL para Windows Verso 7.
Captulo 4
Comandos
Dialog (Dilogo)
153
(Novo).
Na janela Viso geral, clique duas vezes no batch para o qual voc deseja criar
uma caixa de dilogo. O ACL perguntar se deseja editar ou executar o batch.
Clique em [Editar].
154
Manual de Referncia
Texto
Caixa de edio
Caixa de verificao
Boto de rdio
Lista suspensa
Lista deItens do Projeto
Excluir
Ajuste grade
rea de definio
Redimensionamento da tela
3. Clique duas vezes na rea de definio em branco. O ACL exibe a caixa de edio do
dilogo.
4. Informe um novo nome para a caixa de dilogo na caixa de texto Ttulo e clique em
[OK].
5. Adicione os controles. (Veja detalhes abaixo.)
6. Feche a janela do Construtor de dilogos. O ACL solicita Salvar alteraes para
caixa de dilogo?
7. Clique em [OK]. O ACL exibe a linha de comando do Construtor de dilogos na
janela do batch. Voc pode visualizar todos os controles na caixa de dilogo, rolando
para a direita.
Linha de comando do Construtor de dilogos
8. Feche a janela de batch. O ACL avisa que o batch foi alterado. Execute um dos
seguintes procedimentos:
9. Clique em [OK].
Captulo 4
Comandos
Dialog (Dilogo)
155
Controles
Usando o Construtor de dilogos, voc pode construir controles nas caixas de dilogo
personalizadas que so usadas pelo batch para interagir com o usurio durante o
processamento. Voc pode criar os seguintes controles:
Mensagens de texto
Caixas de edio
Caixas de verificao
Botes de opo
Listas suspensas
Listas suspensas
Marcas de grade
Caixa de edio
Lista de itens do
Projeto
Caixas de
verificao
Botes de
rdio
Voc pode alterar os parmetros ou caractersticas de cada controle atravs de sua caixa
de dilogo. Embora o escopo dos parmetros varie para cada tipo de controle, todos tm
parmetros de Posio e Tamanho. Esses parmetros permitem que voc especifique as
posies horizontal e vertical do canto superior esquerdo do controle e a altura e largura
do controle, em pixels. Assinale a caixa Auto para que o ACL redimensione automaticamente a caixa, quando seu contedo for alterado. Voc tambm pode alterar a Posio e
o Tamanho no prprio Construtor de dilogos. Para obter mais informaes, consulte
Editar controles na pgina 162.
Nota: Para obter uma aparncia mais consistente, mantenha as caixas Auto assinaladas
e a opo Ajuste grade ativa. As marcas de grade na rea de definio indicam que a
opo est ativa.
156
Manual de Referncia
Mensagens de texto
Uma mensagem de texto exibe um texto esttico que avisa ou informa o usurio.
Para adicionar uma mensagem de texto, faa o seguinte:
1. No Construtor de dilogos, clique em
(Texto) e, em seguida, clique na rea de
definio na qual deseja colocar a parte superior esquerda do controle. O ACL exibe
a caixa de dilogo Texto.
Caixas de edio
Use uma caixa de edio em seu batch para receber entradas do usurio. Esse controle
cria uma varivel de caractere.
Captulo 4
Comandos
Dialog (Dilogo)
157
2. Digite o nome da varivel que conter o valor desse controle, na caixa de texto
Varivel.
3. Informe o texto na caixa Texto padro para determinar o valor padro da varivel.
4. Clique em [OK].
Caixas de verificao
Uma caixa de verificao apresenta opes de Falso ou Verdadeiro (Ativar ou Desativar)
ao usurio. Os usurios podem selecionar mais de uma opo dentro de um conjunto.
Esse controle cria uma varivel lgica que ser Verdadeira se a caixa de seleo estiver
assinalada e Falso, caso contrrio.
158
Manual de Referncia
2. Digite o texto a ser exibido ao lado da caixa de verificao, na caixa de texto Rtulo.
3. Informe o nome da varivel que conter o valor desse controle, na caixa de texto
Varivel.
4. Selecione Marcada ou Desmarcada para determinar o valor padro da varivel.
5. Clique em [OK].
Botes de opo
Um conjunto de botes de opo apresenta opes mutuamente exclusivas ao usurio.
Somente uma opo pode ser selecionada em um conjunto de botes. Esse controle cria
uma varivel numrica que contm 1, se o primeiro boto de opo for selecionado, 2,
se o segundo boto de opo for selecionado, e assim por diante.
Captulo 4
Comandos
Dialog (Dilogo)
159
2. Digite o texto na caixa de texto Rtulo para criar um boto de rdio e o texto a ser
exibido ao lado dele.
3. Clique em [Adicionar] para adicionar o item Lista de rtulo.
4. Crie pelo menos um boto rdio a mais e adicione-o Lista de rtulo.
5. Digite o nome da varivel que dever conter o valor desse controle na caixa de texto
Varivel.
6. Destaque um item na caixa Lista de rtulo e clique em [Definir padro] para determinar o valor padro da varivel.
7. Especifique se os botes de rdio sero posicionados horizontalmente, lado a lado
ou verticalmente, um acima do outro, usando a opo Alinhamento.
8. Clique em [OK].
Listas suspensas
Uma lista suspensa apresenta uma lista de itens ao usurio. Somente um item pode ser
selecionado. Esse controle cria uma varivel de caractere que contm o texto do item
selecionado.
160
Manual de Referncia
2. Informe o texto na caixa de texto Rtulo para criar itens e clique em [Adicionar]
para adicion-los Lista de rtulo.
3. Digite o nome da varivel que dever conter o valor desse controle, na caixa de texto
Varivel.
4. Destaque um item na caixa Lista de rtulo e clique em [Definir padro] para determinar o valor padro da varivel.
5. Clique em [OK].
Batches
Exibies
reas de trabalho
Captulo 4
Comandos
Dialog (Dilogo)
161
ndices
Por exemplo, voc pode criar uma Lista de itens do projeto para exibir todas as
definies de arquivo de entrada. Quando o usurio seleciona uma definio de arquivo
de entrada, o batch pode usar um comando de macro para abrir essa definio e analisar
os dados. Para obter mais informaes sobre o uso de macros, consulte Macro de
substituio na pgina 349.
Para adicionar uma Lista de itens do projeto, faa o seguinte:
1. No Construtor de dilogos, clique em
(Lista de itens do projeto) e, em seguida,
clique na rea de definio na qual deseja colocar a parte superior esquerda do
controle. O ACL exibe a caixa de dilogo Lista de itens do projeto.
162
Manual de Referncia
Editar controles
Para editar um controle, siga esses passos:
1. Clique duas vezes no controle. O ACL exibe a caixa de dialgo para edio do
controle.
2. Edite os parmetros para o controle.
3. Clique em [OK].
Voc pode alterar a posio de um controle no Construtor de dilogos clicando no
controle e arrastando para uma nova posio.
Voc pode alterar o tamanho de um controle no Construtor de dilogos clicando no
controle e arrastando seus redimensionadores de tela.
Nota: Para obter uma aparncia mais consistente, mantenha a opo Ajuste Grade
ativa. As marcas de grade na rea de definio indicam que a opo est ativa.
Excluir controles
Para excluir um controle, faa o seguinte:
1. Clique no controle para selecion-lo.
2. Clique em
(Excluir).
Captulo 4
Comandos
Dialog (Dilogo)
163
4. Clique em
(Editar comando). O ACL exibe o Construtor de dilogos criado por
esse comando.
164
Manual de Referncia
esquerdo do controle.
nmero corresponde ordem na qual os itens so especificados. No conjunto de botes
mantido.
item1;item2;... especifica os rtulos para as opes no controle.
ndice_item especifica as categorias em uma Lista de itens de projeto. Cada categoria
representada por uma letra.
Captulo 4
Comandos
Display (Exibir)
165
ndice
Batches
Campos de caractere
Variveis de caractere
Campos de data
Variveis de data
ndices
Campos lgicos
Variveis lgicas
Campos numricos
Variveis numricas
Exibies
reas de trabalho
Display (Exibir)
Use o comando Exibir para exibir informaes sobre o ambiente ACL atual. As informaes exibidas dependem da palavra-chave que voc especifica.
Este comando s pode ser executado no modo de comandos. Para obter mais informaes, consulte Macro de substituio na pgina 349 do Guia do Usurio do
ACL para Windows.
Parmetros
O comando Display (Exibir) tem os seguintes parmetros: Date (Data), Free (Livre),
History (Histrico), Open (Abrir), Primary (Primrios), Secondary (Secundrios),
Relation (Relacionamentos), Space (Espao), Time (Hora), Variables (Variveis),
Version (Verso).
166
Manual de Referncia
Date (Data)
Exibe a data e hora atuais, conforme definido pelo sistema operacional de seu computador.
Free (Livre)
Exibe a quantidade de memria (RAM) disponvel para uso. A quantidade exibida no
inclui a RAM reservada para variveis.
History (Histrico)
Exibe o histrico do arquivo, conforme descrito em File history (Histrico do
arquivo) na pgina 194.
Open (Abrir)
Exibe todos os arquivos abertos do Projeto ACL atual.
Relation (Relacionamentos)
Exibe os arquivos relacionados na definio de arquivo de entrada.
Space (Espao)
Exibe a quantidade de memria (RAM) disponvel para uso; sinnimo de Livre.
Time (Hora)
Exibe a data e hora atuais, conforme definido pelo sistema operacional de seu computador e sinnimo de Data.
Variables (Variveis)
Exibe os valores das variveis definidas pelo comando Atribuir e os valores criados
automaticamente por certos comandos do ACL. Exibe tambm a quantidade de espao
restante para variveis adicionais.
Nota: A quantidade de espao padro para variveis de 60K. No entanto, o ACL
aumenta automaticamente a quantidade de espao disponvel para armazenar variveis,
quando necessrio.
Captulo 4
Comandos
Do Batch (Executar batch)
167
Version (Verso)
Exibe a verso do ACL que est sendo executada.
Exemplo
Para exibir a definio de arquivo de entrada para o arquivo primrio, Inventory, digite
DISPLAY na caixa de texto do Log de comando.
O ACL exibe o resultado no Log de comando:
168
Manual de Referncia
(Executar batch). O teste Se avaliado apenas uma vez, para determinar se o batch deve
ser executado e no aplicado individualmente para cada registro do arquivo. Se o teste
resultar em falso para o registro atual, o batch no ser executado. Portanto, voc no
poder colocar o comando Executar batch em um grupo. Veja as explicaes de Se e
Enquanto a seguir.
Nota: Se voc descobrir que seu arquivo de batch no est como voc queria, possvel
edit-lo. Clique duas vezes no nome exibido na janela Viso geral e selecione [Editar].
Ao digitar em uma janela de batch, voc pode desfazer a ltima digitao pressionando
CTRL-Z.
Para obter mais informaes, consulte Batches na pgina 261 do Guia do Usurio do
ACL para Windows.
Parmetros
O comando Do Batch (Executar batch) tem os seguintes parmetros de comando
comuns: If (Se), While (Enquanto). Para obter uma descrio, consulte o Captulo 3:
Parmetros de comandos comuns.
Exemplo
Para executar um batch, Inventory_count_prep, que fornece uma viso geral bsica do
estoque antes de realizar uma contagem de estoque, use Executar batch.
Selecione Inventory_count_prep na caixa de dilogo Executar batch.
Captulo 4
Comandos
Do Batch (Executar batch)
169
170
Manual de Referncia
Dump (Descarregar)
Use o comando Dump (Descarregar) para exibir o contedo de um arquivo especificado ou do registro atual em formato hexadecimal, ASCII e EBCDIC.
O comando Descarregar til se voc tem problemas para definir um formato ou
encontrou dados invlidos no arquivo.
Nota: Voc no pode emitir o comando Descarregar por meio de um batch.
Parmetros
O comando Dump (Descarregar) tem os seguintes parmetros: ASCII, Columns
(Colunas), EBCDIC, File (Arquivo), Find (Localizar), HEX, Horizontal, Position
(Posio), Record (Registro), Refresh (Atualizar), Skip Bytes (Ignorar bytes).
Captulo 4
Comandos
Dump (Descarregar)
171
ASCII
Exibe dados em formato ASCII.
Columns (Colunas)
Altera a largura da exibio. Consulte COLUMNS no comando Sintaxe do Modo de
Comando abaixo.
Para alterar a largura da exibio, informe um nmero na caixa de texto, ou clique nos
controles para cima e para baixo ao lado da caixa de rolagem Colunas, para aumentar ou
diminuir o nmero de bytes exibidos em cada linha.
EBCDIC
Exibe os dados no formato EBCDIC.
File (Arquivo)
Exibe o contedo de um arquivo em um ou mais dos formatos hexadecimal, ASCII, e
EBCDIC. Quando voc seleciona Arquivo, o ACL exibe uma caixa de dilogo Abrir,
permitindo escolher o arquivo que deseja.
Find (Localizar)
Localiza um valor especificado nos dados. Por exemplo, para localizar o valor 39 no
formato hexadecimal:
1. Na caixa de dilogo Descarregar, clique em [Localizar] para exibir a caixa de dilogo
Localizar.
172
Manual de Referncia
HEX
Exibe dados em formato hexadecimal.
Horizontal
Exibe os dados em formato horizontal. Consulte HORIZONTAL na Sintaxe de Modo de
Comando abaixo.
Position (Posio)
Mostra qual byte est selecionado no momento.
Record (Registro)
Exibe o contedo de um registro em formatos hexadecimal, ASCII e EBCDIC. Voc
pode selecionar uma ou mais dessas opes de formato.
Refresh (Atualizar)
Leva voc at o incio da exibio do comando Descarregar (Dump), se o incio do
arquivo estiver fora da exibio.
Captulo 4
Comandos
Dump (Descarregar)
173
Para exibir um registro em particular, use o comando Locate (Buscar). Por exemplo, se
voc digitar LOCATE RECORD 13 na linha acima do Dump Record, o Dump exibe o
registro 13.
nome-do-arquivo especifica o nome do arquivo que voc deseja exibir.
SKIP n especifica quantos bytes ignorar antes de se descarregar os dados. O padro 0.
COLUMNS especifica a largura da sada, em termos de nmero de bytes a serem exibidos
em cada linha. No modo padro desse comando, a largura real da exibio aproximadamente quatro vezes a largura de Colunas, j que os dados so exibidos em formatos
hexadecimal, ASCII e EBCDIC. Para exibies horizontais, a largura de aproximadamente 12 caracteres maior que o valor de COLUMNS. O padro 16 para exibio
vertical e 64 para exibio horizontal.
174
Manual de Referncia
Duplicates (Duplicidades)
O comando Duplicidades uma variao do comando Seqncia e usado para
detectar se os campos-chave do arquivo atual contm duplicidades na seqncia.
Voc pode tambm assinalar a caixa Duplicidades, na caixa de dilogo do comando
Seqncia. Entretanto, a seleo do comando Duplicidades faz com que o ACL selecione
a caixa de seleo Duplicidades como padro.
Para obter mais informaes, consulte Sequence (Seqncia) na pgina 298.
Parmetros
O comando Duplicates (Duplicidades) tem os seguintes parmetros de comando
comuns: All (Tudo), Append (Anexar a um arquivo existente), File (Arquivo), File Type
(Tipo de arquivo), First (Primeiros), Footer (Rodap), Graph (Grfico), Header
(Cabealho), If (Se), Local (Local), Name (Nome), Next (Prximo), Print (Imprimir),
Screen (Tela), While (Enquanto). Para obter uma descrio, consulte o Captulo 3:
Parmetros de comandos comuns.
Para obter a descrio de outros parmetros, consulte Parmetros na pgina 299.
Captulo 4
Comandos
Else (Seno)
175
Exemplo
Consulte Exemplo 1 na pgina 301.
Else (Seno)
Use o comando Seno para obter um conjunto alternativo de comandos quando um
teste Grupo Se falhar em um grupo condicional. O comando Seno tambm pode ter
sua prpria condio.
Seno usado somente em um grupo, nunca sozinho. Como os grupos so usados
apenas em batches, esse comando s estar disponvel quando uma janela de batch
estiver aberta.
O comando Seno s permitido se o comando Grupo associado contiver um teste.
Neste caso, para cada registro de um arquivo, os comandos entre Grupo e Seno sero
processados se o teste for bem-sucedido, e os comandos entre Seno e Fim sero processados se o teste falhar.
importante observar que todos os comandos so executados, mas dependendo do
valor do teste, somente um dos conjuntos de comandos ser executado para cada
registro. Para obter mais informaes, consulte Grupos na pgina 340 do
Guia do Usurio do ACL para Windows.
Parmetros
O comando Else (Seno) tem o seguinte parmetro comum: If (Se). Para obter a
descrio, consulte o Captulo 3: Parmetros de comandos comuns.
176
Manual de Referncia
Exemplo
Consulte Group (Grupo) na pgina 198.
End (Fim)
Clique em
(Fim) em uma janela de batch para inserir o comando Fim para fechar
ou finalizar um comando Grupo ou Loop.
Fim somente usado em um grupo; nunca sozinho. Como os grupos so usados somente
em batches, este comando est disponvel apenas quando uma janela de batch estiver
aberta. Para obter mais informaes, consulte Grupos na pgina 340 do
Guia do Usurio do ACL para Windows.
Exemplo
Consulte Group (Grupo) na pgina 198.
Evaluate (Avaliar)
O comando Avaliar determina o impacto dos erros de amostragem detectados em uma
populao para um nvel de confiana especificado e estabelece o cenrio do pior
Captulo 4
Comandos
Evaluate (Avaliar)
177
caso, retornando uma freqncia de limite de erro superior para uma amostragem de
registros e um limite de erro superior para uma amostragem monetria.
Nota: Antes de usar Avaliar, voc deve determinar o tamanho da amostra usando o
comando Tamanho do ACL e deve j ter extrado a amostra, usando o comando Amostra
do ACL.
Use Avaliar para determinar o efeito dos erros detectados nos resultados da amostragem
de registros ou monetria.
Nota: A teoria por trs da amostragem estatstica complexa. Se no estiver familiarizado com os julgamentos crticos necessrios para a realizao de uma amostragem
estatstica, recomendamos que consulte um especialista em estatstica antes de usar os
comandos Tamanho, Amostra e Avaliar do ACL.
Nota: Na amostragem por unidade monetria voc pode usar o Avaliar somente para o
mtodo de amostragem de intervalos. Em amostragens por registro, voc pode us-lo para
qualquer mtodo.
O comando Avaliar usa os parmetros da amostragem original e qualquer erro encontrado na amostra para calcular o limite de erro superior para a populao.
Para amostras de registros, o LES o limite de erros (expresso na forma de percentual)
que voc garante que no ser excedido. Por exemplo, voc pode ter 90% de confiana
que a taxa total de erros no exceda 6,5%.
Para amostras monetrias, os erros registrados so processados e relatados em detalhes.
O relatrio inclui os efeitos de cada erro e mostra a quantidade mais provvel de erros
totais, e o LES expresso como uma quantia monetria. Esse o montante que voc est
seguro de que no ser excedido no total de erros. Por exemplo, voc pode fazer uma
estimativa de que os erros mais provveis somaro 50.000, mas tambm pode estar 95%
seguro de que o total de erros no exceder 288.000.
Na avaliao de erros de amostragem, o ACL usa os fatores cumulativos do limite de
erro superior da distribuio de Poisson.
178
Manual de Referncia
LES cumulativo
Tamanho da amostra
Captulo 4
Comandos
Evaluate (Avaliar)
179
Por fim, os erros mais provveis so acumulados para produzir o total de erros
mais provveis para os erros de amostra observados. Do mesmo modo, a
preciso bsica somada a todos os fatores de ajuste de preciso referentes aos
erros observados, a fim de produzir o limite de erro superior para a amostra
dentro da confiabilidade exigida.
Parmetros
Alm dos parmetros descritos abaixo, o comando Evaluate (Avaliar) tem os seguintes
parmetros: File (Arquivo), File Type (Tipo de arquivo), Footer (Rodap), Graph
(Grfico), Header (Cabealho), Local (Local), Name (Nome), Print (Imprimir), Screen
(Tela), To (Para). Para obter uma descrio desses parmetros, consulte Captulo 3:
Parmetros de comandos comuns.
Monetary (Monetrio)
Especifica o tipo de amostragem monetria.
Record (Registro)
Especifica o tipo de amostragem de registros.
Confidence (Confiabilidade)
Especifica o nvel de confiabilidade, informado como um percentual.
Interval (Intervalo)
Especifica o intervalo de amostragem utilizado para a extrao da amostra. Consulte
Amostragem por intervalo fixo na pgina 280.
180
Manual de Referncia
Errors (Erros)
Especifica o valor registrado para o item da amostra e o valor do erro associado quele
item. Por exemplo, se o valor registrado 700, mas deveria ter sido 900, o item valor
700 e o valor de erro 200. Ao digitar, separe os dois valores com um ponto e vrgula.
Para amostragem por unidade monetria, informe valores positivos para erros de
superestimao e valores negativos para erros de subestimao. Por exemplo:
Se o valor do amostrado 100, mas a investigao mostra que deveria ser 75, o
item est superestimado em 25. Digite 100;25 na caixa de texto Erros.
Se o valor do amostrado 100, mas deveria ter sido 125, esse item est subestimado. Digite 100;25 na caixa de texto Erros.
Voc registra o valor subestimado como negativo, uma vez que o oposto do
superestimado.
Captulo 4
Comandos
Evaluate (Avaliar)
181
Para exibir as opes para amostragem de registros, clique no boto de opo Registro.
Exemplo 1
Para avaliar o limite de erro superior para uma amostra de registros com 95% de confiabilidade, dado um tamanho de amostra de 120 e 3 erros encontrados na amostra:
Voc pode ter 95% de confiabilidade de que a taxa de erros na populao no excede
6,47%.
Exemplo 2
Para avaliar o limite de erro superior para uma amostragem monetria com 90% de
confiana, dado um intervalo de amostragem de 300.000 e trs valores de item e de erro.
182
Manual de Referncia
Captulo 4
Comandos
Export (Exportar)
183
Export (Exportar)
Use o comando Export para criar arquivos que sero utilizados em:
Bancos de dados
Processadores de texto
O comando Export permite que voc converta dados de campos selecionados nestes
formatos:
Texto delimitado
Lotus 1-2-3
Microsoft Excel
Texto simples
XML
O comando Export permite que voc use o ACL como uma ferramenta de converso de
dados, obtendo dados de um pacote e produzindo um arquivo de exportao em um
formato que possa ser lido por outro pacote.
O comando Export freqentemente usado como a ltima etapa na produo de cartas
de confirmao. Por exemplo, voc pode usar o comando Size para determinar seu
intervalo de amostragem e, depois, usar Sample para criar uma amostra apropriada. Por
fim, voc pode usar Export para converter o arquivo de amostra de resultado em um
arquivo .doc do Word que pode ser usado em operaes de mesclagem do Word.
184
Manual de Referncia
Criar um novo banco de dados do Access 2000. Seus dados so includos em uma
nova tabela.
Exportar seus dados para um banco de dados existente do Access 2000. Voc
pode criar uma nova tabela ou sobrescrever uma j existente. Voc pode determinar que um aviso seja exibido antes de sobrescrever. Para obter mais informaes, consulte Avisar antes de substituir arquivos na pgina 312 do
Guia do Usurio do ACL para Windows.
Exportando XML
Voc pode exportar seus dados em XML usando o comando Export. O XML resultante
pode ser editado em qualquer processador de texto e pode ser usado por qualquer
sistema de processamento ou aplicativo XML.
Parmetros
O comando Export (Exportar) tem os seguintes parmetros: All (Tudo), Append
(Anexar a um arquivo existente), File (Arquivo), File Type (Tipo de Arquivo), First
(Primeiros), If (Se), Local (Local), Next (Prximo), To (Para), While (Enquanto). Para
uma descrio desses parmetros, consulte Captulo 3: Parmetros de comandos
comuns.
Captulo 4
Comandos
Export (Exportar)
185
Exemplo
Use Exportar para produzir cartas de confirmao.
Voc tem informaes em um arquivo personalizado de que necessita para confirmaes de endereo, mas o arquivo no est formatado do modo que voc gostaria.
Para alterar o formato, voc pode exportar o arquivo para um arquivo secundrio para
mesclagem, a fim de ser utilizado em um programa de processamento de texto, como o
186
Manual de Referncia
Microsoft Word. Exporte todos os campos, exceto o campo de limite de crdito, que no
necessrio para produzir as confirmaes.
O novo arquivo Customer_master est agora pronto para ser usado em mesclagens no
Microsoft Word, sem edies e formataes.
Extract (Extrair)
Use o comando Extrair para extrair registros ou campos selecionados do arquivo atual e
copi-los para um arquivo diferente.
H vrios motivos para usar Extrair na criao de um subconjunto de um arquivo
original. Por exemplo, voc pode usar Extrair antes de ordenar um arquivo, a fim de
Captulo 4
Comandos
Extract (Extrair)
187
reduzir o seu tamanho e o tempo de processamento. Voc tambm pode usar Extrair
para isolar itens incomuns em um arquivo separado para anlise posterior.
possvel extrair registros inteiros do arquivo de entrada, incluindo quaisquer dados
armazenados em reas indefinidas na definio de arquivo de entrada. As definies de
campo no arquivo de destino so idnticas quelas do arquivo fonte, incluindo
quaisquer definies de campos calculados.
Nota: A extrao de registros de um arquivo que contm campos estticos e/ou estticos
condicionais pode gerar resultados imprevistos. Certifique-se de selecionar apenas os
campos desejados.
Voc tambm pode extrair campos especificados de um registro. Quando voc escolhe
essa opo, o ACL gera automaticamente definies de campo para o arquivo de
destino. Os campos calculados includos na lista de campos so analisados antes da
extrao, de modo que formem parte da definio de arquivo de entrada no arquivo de
destino. Seus tipos de campos sero Lgico, Data, ASCII ou ACL, em vez de
Computado. Esse arquivo ter Comprimento de Registro fixo.
Nota: Se voc selecionar todos os campos da caixa de listagem Extrair, o resultado poder
no ser idntico ao de extrair um registro. A seleo de campos dessa forma ignora todas as
partes indefinidas do registro. Ao extrair um registro inteiro, voc extrai at mesmo as
partes indefinidas.
Nota: Ao processar arquivos do servidor que contm arquivos relacionados, a sada tipo
registro ser alterada para todos os campos de sada, se voc especificar a opo ou
palavra-chave local.
Parmetros
Alm do parmetro descrito abaixo, o comando Extract (Extrair) tem os seguintes
parmetros: All (Tudo), Append (Anexar a um arquivo existente), End Of File (Fim de
arquivo), Fields (Campos), First (Primeiros), If (Se), Next (Prximo), Record
(Registro), While (Enquanto). Para a descrio desses parmetros, consulte o
Captulo 3: Parmetros de comandos comuns.
Extrair campos
Permite selecionar os campos ou expresses a serem extrados. Voc pode destacar os
campos na caixa de listagem Extrair campos ou clicar em [Extrair campos] para abrir a
caixa de dilogo Campos selecionados. Consulte Caixas de dilogo selecionar/editar
na pgina 40 do Guia do Usurio do ACL para Windows.
188
Manual de Referncia
Exemplo 1
Se voc descobrir que um arquivo de estoque tem valores negativos para a quantidade
disponvel ou valor registrado, voc pode querer extrair esses registros excepcionais
para um novo arquivo, Negative_value, para investigao posterior.
Captulo 4
Comandos
Extract (Extrair)
189
Exemplo 2
Para criar um arquivo que contenha somente os campos que voc considere teis para
suas anlises, use Extrair. Lembre-se de selecionar os campos na ordem em que devem
aparecer em sua exibio.
Extraia os campos para classe de produto, descrio de produto, nmero do produto,
quantidade disponvel e valor registrado para o arquivo Inventory_extract (nem todos
os campos selecionados esto visveis na caixa de listagem do exemplo.)
190
Manual de Referncia
Captulo 4
Comandos
Fieldshift (Deslocar campos)
191
Parmetros
O comando Fieldshift (Deslocar campos) tem os seguintes parmetros: Colunas [Bytes
a deslocar], [Posio] Inicial, OK.
Columns (Colunas)
Especifica o nmero de bytes a serem deslocados para a direita (+) ou esquerda (-).
Start (Inicial)
Especifica a posio inicial do primeiro campo que voc deseja deslocar.
OK
Indica que o comando dever ser executado sem confirmao.
192
Manual de Referncia
Captulo 4
Comandos
Fieldshift (Deslocar campos)
193
Selecione o nome
do filtro para os
campos de um tipo
de registro
especfico.
deslocar.
bytes-a-deslocar especifica o nmero de bytes a deslocar.
nome-do-filtro-de-dados especifica o nome do filtro que identifica os campos
relacionados com um tipo de registro em particular.
Exemplo
O comando a seguir desloca o campo iniciando no byte 12 e todos os campos subseqentes 4 bytes direita.
FIELDSHIFT START 12 COLUMNS 4
194
Manual de Referncia
Os comandos utilizados
Os totais de controle de entrada e sada (se voc especificar um campo para total
de controle)
Para que haja um histrico, o arquivo precisa ter sido criado por um comando do ACL.
Para definir o nmero mximo de entradas de histrico, use o comando Set History
(Definir histrico). Para obter mais informaes, consulte Set History (Definir
histrico) na pgina 306.
Exemplo 1
Por exemplo, se o arquivo A (o arquivo de entrada original) foi ordenado para o arquivo
B que, por sua vez, foi extrado para o arquivo C, o qual foi sumarizado para o arquivo
D, o Histrico do arquivo D mostraria:
Captulo 4
Comandos
Find (Localizar)
195
Exemplo 2
Para exibir o histrico do arquivo criado no Exemplo 1 na pgina 188, use Histrico
do arquivo.
Find (Localizar)
Use o comando Localizar para mover-se diretamente para o primeiro registro contendo
uma chave de pesquisa tipo caractere especificada em um arquivo indexado.
O comando Localizar permite localizar um registro especfico. Voc pode, ento, exibir
ou executar os clculos sobre seu contedo, ou comparar o contedo de um registro
com o de outro.
Se o valor da chave de pesquisa for localizado, o ACL ir posicionar o arquivo naquele
registro. Se o valor no for localizado, o ACL exibir a mensagem Nenhum ndice
corresponde chave, e o arquivo ser posicionado no primeiro registro com um valor
da chave de pesquisa maior que o valor especificado.
Nota: O comando Localizar a opo Localizar literal do comando Pesquisar. Para usar o
comando Pesquisar, selecione Analisar na barra de menus e escolha Pesquisar. Consulte
Search (Pesquisar) na pgina 291 para obter detalhes.
196
Manual de Referncia
Este comando pode ser ativado somente no modo de comando, embora a opo
Pesquisar no menu Analisar tambm fornea acesso ao comando Localizar. Para obter
mais informaes, consulte Emitir comandos na pgina 267 do Guia do Usurio do
ACL para Windows.
Pr-requisitos
O arquivo de entrada deve ser indexado com base em, no mnimo, um campo-chave de
caracteres em ordem crescente. O comando Localizar no opera nas partes dos
campos-chave de ndice que no sejam do tipo caractere ou que estejam em ordem
decrescente.
Exemplo
Para mover-se para o primeiro registro contendo LATEX em um arquivo de estoque que
tenha sido indexado por descrio de produto, use Localizar.
Digite FIND LATEX na caixa de texto do Log de comando.
O ACL exibir o primeiro registro no arquivo cuja descrio de produto contenha a
chave de pesquisa, LATEX.
Captulo 4
Comandos
Gaps (Falhas)
197
Gaps (Falhas)
O comando Falhas uma variao do comando Seqncia e usado para detectar falhas
em campos-chave numricos do arquivo atual.
Voc tambm pode selecionar a caixa de verificao Falhas na caixa de dilogo do
comando Seqncia. Entretanto, a seleo do comando Falhas faz com que o ACL
selecione a caixa Falhas como padro.
Se voc executar o comando Falhas em um campo que tenha caracteres misturados com
nmeros, por exemplo A12345, os caracteres sero ignorados e somente os nmeros
sero testados para verificar a existncia de falhas. Por exemplo, se o campo no prximo
registro for B12346, o ACL no ir relatar a existncia de nenhuma falha, j que A e
B seriam ignorados nos campos.
Para obter mais informaes, consulte Sequence (Seqncia) na pgina 298.
Parmetros
O comando Gaps (Falhas) tem os seguintes parmetros de comando comuns: All
(Tudo), Append (Anexar a um arquivo existente), File (Arquivo), File Type (Tipo de
arquivo), First (Primeiros), Footer (Rodap), Graph (Grfico), Header (Cabealho), If
(Se), Local (Local), Name (Nome), Next (Prximo), Print (Imprimir), Screen (Tela),
While (Enquanto). Para obter uma descrio, consulte o Captulo 3: Parmetros de
comandos comuns.
Para obter a descrio de outros parmetros, consulte Parmetros na pgina 299.
198
Manual de Referncia
Exemplo
Consulte Exemplo 1 na pgina 301.
Group (Grupo)
Use o comando Grupo em um batch para processar, ao mesmo tempo, um conjunto de
comandos em uma nica passagem pelo arquivo de entrada. Uma vez que os grupos
agregam comandos, de modo que sejam ativados ao mesmo tempo em relao a cada
registro no arquivo de entrada, voc pode reduzir significativamente o tempo de processamento.
Somente comandos baseados em registro e certos comandos de operao de batch so
apropriados para uso no grupo. Esses comandos incluem: Associar, Atribuir, Cancelar,
Classificar, Comentrio, Contar, Duplicidades, Estatsticas, Estratificar, Exportar,
Extrair, Falhas, Fim, Histograma, Listar, Loop, Mesclar, Perfil, Perodo, Relatrio,
Seno, Seqncia, Sumarizar, Total e Verificar.
Os grupos so usados somente em batches. Dentro de cada batch, voc pode incluir um
ou mais grupos simples, condicionais ou aninhados. Antes de criar um grupo, voc deve
estar familiarizado com os conceitos envolvidos na criao de batches. Para obter mais
informaes, consulte Batches na pgina 261 do Guia do Usurio do
ACL para Windows.
Captulo 4
Comandos
Group (Grupo)
199
Parmetros
O comando Group (Grupo) tem os seguintes parmetros: While (Enquanto), First
(Primeiros), Next (Prximo), If (Se) e All (Tudo). Para a descrio desses parmetros,
consulte o Captulo 3: Parmetros de comandos comuns.
Exemplo
Para criar um grupo, siga esses passos:
1. Abra um batch. O ACL exibir a janela de batch.
2. Clique em
(Fim).
200
Manual de Referncia
Voc tambm pode incluir um comando Loop em um grupo quando precisar executar
uma srie de comandos mais de uma vez, em relao a informaes repetidas em um
registro em particular. O comando Loop comporta-se similarmente ao comando
Group, exceto pelos comandos entre Loop e End (Fim) serem executados repetidamente, em relao ao registro atual, at que o resultado do teste seja falso. Para obter
mais informaes, consulte Loop na pgina 232.
Grupos simples
O grupos simples iniciam-se com um comando Group (Grupo), so seguidos por uma
srie de comandos e terminam com um comando End (Fim). Por exemplo:
GROUP
COUNT
HISTOGRAM ON QtyOH MINIMUM 0 MAXIMUM 100 INTERVALS 10
CLASSIFY ON Loc ACCUMULATE QtyOH
END
Grupos condicionais
Grupos condicionais executam comandos baseados em uma condio verdadeira ou
falsa. Por exemplo, o comando Group a seguir executado somente em registros com
um campo ProdCls cujo valor menor que 5:
GROUP IF ProdCls < "05"
COUNT
HISTOGRAM ON QtyOH MINIMUM 0 MAXIMUM 100 INTERVALS 10
CLASSIFY ON Loc ACCUMULATE QtyOH
END
Captulo 4
Comandos
Group (Grupo)
201
Voc pode incluir instrues Else/If (Seno/Se) mltiplas em um grupo, contanto que
elas contenham um teste diferente. No exemplo a seguir, as instrues Else/If produzem
quatro totais:
GROUP IF ProdCls < "05"
COUNT
HISTOGRAM ON QtyOH MINIMUM 0 MAXIMUM 100 INTERVALS 10
CLASSIFY ON Loc ACCUMULATE QtyOH
ELSE IF ProdCls = "05"
TOTAL QtyOH
ELSE IF ProdCls = "06"
TOTAL QtyOH
ELSE IF ProdCls = "07"
TOTAL QtyOH
ELSE
TOTAL QtyOH
END
ProdCls < 05 ?
Se sim, execute os comandos contar, Histograma e Classificar.
Se no, igual a 05?
Se sim, totalize o campo QtyOH para todos os registros nos quais ProdCls = 05
Se no, igual a 06?
Se sim, totalize o campo QtyOH para todos os registros nos quais ProdCls = 06
Se no, igual a 07?
Se sim, totalize o campo QtyOH para todos os registros nos quais
ProdCls = 07
Se no, totalize o campo QtyOH para todos os registros que no atendam
a nenhum dos testes acima.
202
Manual de Referncia
Grupos aninhados
Grupos aninhados so grupos includos em outros grupos. Os grupos aninhados representam um meio eficiente de controlar quais comandos sero executados para quais
registros. A maioria das aplicaes no necessita de um recurso to avanado, mas esse
recurso est disponvel, se necessrio.
Como em outros grupos, use o comando End (Fim) para encerrar um grupo aninhado.
O ACL iniciar o processamento dos dados somente aps o trmino de todos os
comandos do grupo. Por exemplo:
GROUP IF ProdCls < "05"
COUNT
EXTRACT ON QtyOH ACCUMULATE QtyOH MIN 0 MAX 100 INT 10
GROUP IF QtyOH > 0
STATISTICS ON QtyOH
HISTOGRAM ON QtyOH IF ProdStat = "B"
END
ELSE
TOTAL QtyOH
END
Variveis em grupos
O uso de variveis um mtodo eficiente de armazenar informaes de um registro
para utilizar com informaes de registros relacionados posteriormente. As variveis
tambm permitem que os valores sejam acumulados para um conjunto de registros
relacionados.
Por exemplo, imagine que voc tem um arquivo de transaes de contas a receber
ordenado pelo campo CustNo, a partir do qual voc deseja criar um total acumulado
Captulo 4
Comandos
Help (Ajuda)
203
para cada campo de Valor da transao por cliente (Amount) e gravar todas as
transaes com seus totais de execuo em um novo arquivo para anlise posterior.
V_CUSTNO=CustNo
V_AMOUNT=0,00
GROUP IF V_CUSTNO=CustNo
V_AMOUNT=V_AMOUNT+Amount
EXTRACT V_CUSTNO Amount V_AMOUNT TO "TotalsCust.fil"
ELSE
EXTRACT V_CUSTNO Amount V_AMOUNT TO "TotalsCust.fil"
V_AMOUNT=Amount
V_CUSTNO=CustNo
END
Para obter mais informaes, consulte Variveis na pgina 343 do Guia do Usurio do
ACL para Windows.
Help (Ajuda)
A ajuda on-line do ACL permite que voc navegue para obter informaes sobre a utilizao do ACL. Ela contm informaes completas sobre comandos, funes, recursos e
tipos de campos.
Boto Ajuda
Selecione Ajuda na barra de menus e escolha Contedo, ou clique em
barra de botes.
(Ajuda) na
Em uma janela de batch, voc pode selecionar o nome de um comando para obter ajuda
sobre o comando selecionado.
As informaes de ajuda no so registradas no arquivo de Log.
Histogram (Histograma)
Use o comando Histograma para produzir um grfico de barras verticais 3D da distribuio de registros sobre valores de um campo ou expresso. Voc pode enviar o
204
Manual de Referncia
resultado para um arquivo, para a tela, ou para uma impressora, ou uma vez que os
dados estejam em formato de grfico possvel especificar outros tipos de grficos. O
histograma til para fornecer uma viso geral do contedo do arquivo. O comando
Histograma trabalha com dados no-ordenados.
Para obter detalhes sobre as opes de sada, consulte Grficos na pgina 229 do
Guia do Usurio do ACL para Windows e Sada para grfico na pgina 263 do
Guia do Usurio do ACL para Windows.
Uma representao horizontal do grfico tambm aparece no Log de comando. Uma
ocorrncia em um determinado intervalo de valores de campo ou expresso representada por um asterisco (*). Cada asterisco pode representar um nmero individual,
parcial ou mltiplo de ocorrncias, conforme necessrio, para ajustar o histograma no
nmero de colunas designado. O Log de comando mostra quantas ocorrncias cada
asterisco representa.
Se escolher o grfico, voc pode cham-lo novamente, clicando duas vezes na sada ou
na instruo <<<Dados de grfico>>> no Log de comando.
O comando Histograma oferece as seguintes opes:
Parmetros
Alm dos parmetros descritos abaixo, o comando Histogram (Histograma) tem os
seguintes parmetros: All (Tudo), Append (Anexar a um arquivo existente), Break
(Quebra), File (Arquivo), File Type (Tipo de arquivo), First (Primeiros), Footer
(Rodap), Graph (Grfico), Header (Cabealho), If (Se), Local (Local), Name (Nome),
Next (Prximo), Print (Imprimir), Screen (Tela), Suppress (Suprimir outros), While
(Enquanto). Para a descrio desses parmetros, consulte o Captulo 3: Parmetros de
comandos comuns.
Captulo 4
Comandos
Histogram (Histograma)
205
Columns (Colunas)
Permite que voc especifique o nmero de colunas que deseja para a representao
horizontal do grfico do histograma no Log de comando. Todas as contagens de
intervalo tm a escala ajustada de acordo com o espao disponvel. O padro 78.
Free (Livre)
Especifica pontos iniciais e finais.
Para um histograma numrico, permite especificar o ponto inicial de cada intervalo e o
ponto final do ltimo intervalo. Digite o ponto inicial de cada intervalo na caixa de texto
Livre, um valor por linha. O ltimo nmero digitado interpretado como o ponto final
do intervalo final.
Intervals (Intervalos)
Aplica-se somente a campos numricos. Permite que voc especifique o nmero de
intervalos uniformes que o ACL produz entre o valor mnimo e o mximo.
O padro 10, mas voc pode alterar esse padro na caixa de dilogo Editar preferncias
do ACL.
Para alterar as preferncias da opo de comando, consulte Opes de comando na
pgina 319 do Guia do Usurio do ACL para Windows.
Maximum (Mximo)
Aplica-se somente a campos numricos e permite que voc especifique o valor mximo
do ltimo intervalo. Se voc emitiu um comando Perfil ou Estatsticas, o padro o
valor mais alto no campo numrico. Do contrrio, no h padro.
Minimum (Mnimo)
Aplica-se somente a campos numricos e permite a especificao do valor mnimo do
primeiro intervalo. Se voc emitiu um comando Perfil ou Estatsticas, o padro o valor
mais baixo no campo numrico. Do contrrio, no h padro.
206
Manual de Referncia
Exemplo 1
Voc pode produzir um histograma para mostrar a distribuio do crdito do cliente,
fornecendo informaes que podem ser usadas no ajuste da poltica de crdito.
Para criar um histograma de intervalos uniformemente espaados:
1. Selecione o campo denominado Limite (Limit), na lista suspensa, ou clique em
[Histograma em] para exibir a caixa de dilogo Campos selecionados, a fim de
obter mais informaes detalhadas sobre os campos nesse arquivo. Aps selecionar
um campo, clique em [OK] para retornar caixa de dilogo Histograma.
Campo Selecionado
Especifque mnimo
e mximo
Captulo 4
Comandos
Histogram (Histograma)
207
3. Clique em [OK] para executar o comando e exibir o grfico. O grfico mostra que o
valor mais alto de crdito situa-se no intervalo 50.000.
208
Manual de Referncia
Exemplo 2
O histograma obtido no exemplo 1 mostra que a maior parte do crdito permaneceu no
intervalo de 50.000. Voc pode obter uma quebra posterior dessa distribuio criando
um histograma de intervalos livres.
Para criar um histograma de intervalos livres:
1. Selecione o campo denominado Limite (Limit), na lista suspensa Histograma em.
Especifique um mnimo de 50.000, um mximo de 300.000 e intervalos livres de
50.000, 75.000, 100.000 e 300.000.
2. Clique em [OK] para executar o comando e exibir o grfico. Ele mostra que a
maioria dos limites de crdito situa-se no intervalo entre 50.000 e 75.000 e que
nenhum crdito estendeu-se alm de 100.000.
Captulo 4
Comandos
Histogram (Histograma)
209
210
Manual de Referncia
If (Se)
O comando Se permite especificar uma condio que deve ser atendida para que o
comando que se segue seja executado. A condio se aplica a todo o comando e deve ser
atendida para que o comando continue o processamento.
O comando Se avalia o teste quando o ACL encontra pela primeira vez o comando. Se o
teste resultar em verdadeiro, o comando que se segue ser processado. Se o teste resultar
em falso, o ACL ir ignorar o resto do comando.
Isso difere da condio Se no nvel do comando que testa cada registro do arquivo e
executa o comando nos registros que atendem s condies do teste.
Em um batch, voc pode digitar uma srie de testes de comando Se e executar diversos
comandos com base no resultado. O comando Se mais til para testar uma varivel a
fim de determinar se o arquivo ser processado.
Qualquer comando do ACL vlido pode acompanhar o teste.
Este comando s pode ser executado no modo de comandos e til apenas em batches.
Exemplos
Para executar uma amostra, mas somente se a varivel Count1 for maior que dez:
IF Count1 > 10 SAMPLE Amount...
Suponha que voc tenha emitido previamente um comando Dilogo, com um controle
de caixa de verificao que cria a varivel StartCheckBox (que o usurio pode marcar
para exibir as estatsticas). Voc poderia usar o seguinte comando para produzir as
estatsticas, se solicitado:
IF StatCheckBox STATISTICS ALL
Import (Importar)
Use esse comando para importar dados de uma origem externa para o
ACL para Windows. O comando Import permite importar arquivos em lotes e, em
seguida, realizar outras anlises nesses arquivos, sempre de dentro dos lotes.
Se um arquivo de origem exigir uma senha, use o comando Password para solicit-la ao
usurio a fim de que o comando Import possa ser executado. Consulte Password
(Senha) na pgina 243 para obter detalhes.
Captulo 4
Comandos
Index (ndice)
211
A maneira mais fcil de criar o comando Import consiste em importar usando o Assistente de Definio de Dados e, em seguida, copiar o comando Import do log de
comando e col-lo no lote.
Nota: S necessrio importar dados externos uma vez. Depois disso, voc pode usar o
comando Refresh para atualizar os dados da origem. Consulte Refresh (Atualizar) na
pgina 252 para obter detalhes.
Index (ndice)
Use ndice como um pr-requisito para acessar um arquivo, usando Definir relacionamentos, no modo de comando ou o comando Relacionamentos, na barra de menus.
Alm disso, use o comando ndice para criar um arquivo de ndice que permita acesso
direto aos registros de um arquivo de entrada em uma ordem lgica, ao invs de fsica.
Voc pode ter mais que um arquivo de ndice relacionado a um determinado arquivo de
entrada. Somente um arquivo de ndice pode estar ativo de cada vez.
Antes de usar os arquivos de ndice, consulte Janela Viso geral na pgina 29 do
Guia do Usurio do ACL para Windows e ndice na pgina 101 do Guia do Usurio do
ACL para Windows.
Alguns comandos, como o Definir relacionamentos, exigem que voc indexe os
arquivos relacionados antes de definir os relacionamentos. Para obter mais informaes,
consulte tambm Relations (Relacionamentos) na pgina 253 e Operaes com
vrios arquivos na pgina 103 do Guia do Usurio do ACL para Windows.
Nota: No ser necessrio usar ndice ou Ordenar com Classificar, Perodo, Histograma e
Estratificar, j que esses comandos no exigem um arquivo ordenado.
212
Manual de Referncia
Indexao
Velocidade de execuo
Mais lenta
Mais rpida
Maior
Menor
Mais
Menos
Mais rpido
Mais lento
Mais lento
Mais rpido
Use o comando ndice como uma alternativa ao comando Ordenar, somente quando o
espao no disco for muito limitado ou se voc quiser localizar registros rapidamente
com um valor de chave especfico.
Nota: Se pretende acessar mais que 10% dos registros do arquivo, prefervel ordenar os
dados para otimizar a velocidade de processamento.
O comando ndice cria um arquivo de ndice contendo ponteiros para os registros no
arquivo de entrada aberto. Esses ponteiros so organizados de modo que o arquivo de
entrada possa ser acessado em uma ordem lgica. Por exemplo, ativando a opo
Localizar literal do comando Pesquisar, voc pode localizar registros com valores de
chave especficos muito rapidamente (geralmente em menos de 1 segundo).
Seqncia de ordenao
A chave de ordenao do arquivo de ndice pode conter quantos campos voc quiser at
um comprimento de chave mximo de 255, e cada campo pode estar em ordem
crescente ou decrescente, independentemente dos outros. Os registros so ordenados
com base nos valores de campo, na ordem em que os campos so selecionados. O
primeiro campo selecionado a primeira chave de ordenao, e assim por diante.
As opes Localizar literal e Buscar expresso do comando Pesquisar operam somente
em campos-chave de ndice que sejam do tipo caractere e estejam em ordem crescente.
Voc pode incluir campos no-caractere ou campos decrescentes em um arquivo
Captulo 4
Comandos
Index (ndice)
213
Ativar ndices
H duas maneiras de ativar um arquivo de ndice. Ao criar o ndice pela primeira vez,
certifique-se de que a caixa de seleo Usar arquivo de sada esteja assinalada na caixa de
dilogo ndice. Isso ativa o ndice, quando o comando ndice executado. Para ativar
um ndice previamente criado, clique duas vezes no ndice na janela Viso geral.
Quando o ndice estiver ativado, a palavra Indexado aparecer ao lado da contagem de
registros, na barra de status.
Para verificar se um ndice est ativo, olhe para o meio da barra de status. A janela
indicar x Registros Indexados ou x ndice filtrado, dependendo se o ndice foi ou
no criado com o uso de um filtro.
Dicas de indexao
A seguir, so apresentadas algumas dicas para trabalhar com ndices:
Filtros e condies
Se voc cria um ndice usando um filtro, o ACL exibe ndice filtrado na barra de
status, para inform-lo de que voc s est consultando a parte do arquivo correspondente condio do filtro.
214
Manual de Referncia
Um ndice condicional elimina os registros que no atendem a uma condio especificada. Isso permite que voc crie arquivos de ndice separados para subconjuntos de
um arquivo maior, para manipulao posterior. No inclua uma condio se quiser que
o arquivo inteiro seja indexado.
Alm do teste Se, voc pode selecionar a caixa de dilogo [Mais] e especificar os
parmetros Enquanto, Prximo e Primeiros. Somente os registros do arquivo de
entrada aberto que atenderem condio especificada tero ponteiros no arquivo de
ndice resultante. Se o processamento for finalizado antes por um desses parmetros, os
registros subseqentes no sero includos no arquivo de ndice e no podero ser
acessados quando o arquivo for usado. Nem sempre ser bvio que voc no est trabalhando com o arquivo inteiro. Para assegurar-se de estar trabalhando com um arquivo
indexado, procure a palavra ndice filtrado na barra de status. Somente os registros
que tiverem atendido a condio sero processados pelos comandos executados,
enquanto o ndice estiver ativo.
Parmetros
Alm do parmetro descrito abaixo, o comando Index (ndice) tem os seguintes
parmetros: All (Tudo), Ascending (Crescente), Descending (Decrescente), File
(Arquivo), First (Primeiros), If (Se), Local (Local), Next (Prximo), To (Para), While
(Enquanto). Para a descrio desses parmetros, consulte o Captulo 3: Parmetros de
comandos comuns.
Captulo 4
Comandos
Index (ndice)
215
Criar um ndice
Para criar um novo ndice:
1. Clique em
(ndice) na barra de botes ou selecione Dados na barra de menus e
escolha ndice para exibir a caixa de dilogo ndice.
2. Na caixa de dilogo ndice, selecione um campo na caixa de listagem Indexar em.
Voc pode tambm clicar em [Indexar em]para exibir a caixa de listagem Campos
selecionados, que fornece mais informaes sobre os campos que voc est selecionando.
216
Manual de Referncia
(seta)
Exemplo
Para colocar um arquivo de cliente em ordem alfabtica para facilitar a consulta, use
ndice.
Indexar sobre o campo nome do cliente no arquivo de ndice, Customer_name.
Captulo 4
Comandos
Index (ndice)
217
218
Manual de Referncia
Agora voc pode usar as opes do comando Pesquisar para acessar registros individuais rapidamente. Use a barra de rolagem para visualizar o arquivo inteiro. Observe
que o primeiro registro do arquivo indexado 1st Technology Group. Em um arquivo
indexado, os nmeros so listados antes dos caracteres alfabticos.
Join (Associar)
Use o comando Associar para combinar campos a partir de dois arquivos de entrada
ordenados, formando um terceiro arquivo.
Associar geralmente usado para combinar registros em um arquivo de transao com
aqueles em um arquivo de cadastro. Voc pode, por exemplo, combinar dados de uma
fatura em um arquivo de contas a receber, com dados em um arquivo de cliente, ou
comparar o contedo de dois arquivos.
Ao associar um arquivo de transao e um arquivo mestre, o arquivo de transao ,
geralmente, o arquivo primrio e o arquivo mestre o arquivo secundrio. Identifique
com cuidado seus arquivos primrio e secundrio, uma vez que os resultados diferem se
a ordem dos arquivos for invertida.
Captulo 4
Comandos
Join (Associar)
219
Associar usa mais espao em disco que Relacionamentos, por trs razes:
Primrio
Secundrio
Primrio No- Secundrio No
correspondente correspondente correspondente -correspondente
Registros
correspondentes
Registros
correspondentes:
todos primrios
Registros
correspondentes:
todos secundrios
Registros
correspondentes:
todos primrios e
todos secundrios
Registros nocorrespondentes
220
Manual de Referncia
Registros correspondentes
Cria um arquivo de sada com os campos selecionados dos arquivos primrio e secundrio, para todos os registros do arquivo primrio com correspondncias de
campo-chave no arquivo secundrio.
Se houver mais de um campo-chave correspondente no arquivo secundrio, o ACL usa
o primeiro registro correspondente que encontrar. Se nenhum registro correspondente
for encontrado, nenhum registro de sada ser produzido.
Registros no-correspondentes
Cria um arquivo de sada com todos os registros do arquivo primrio que no tenham
correspondncias no arquivo secundrio. O arquivo de sada s inclui campos
primrios porque no existem informaes secundrias quando os registros no tm
correspondncia.
Captulo 4
Comandos
Join (Associar)
221
Outras opes
Para identificar transaes para as quais no existe nenhum registro de cadastro, especifique o arquivo de transao como um arquivo primrio. Para identificar registros do
cadastro sem nenhuma transao correspondente, especifique o arquivo de cadastro e
como arquivo primrio.
Preparando os campos-chave
possvel selecionar mais de um campo-chave. Voc pode fazer isso, por exemplo, se
tiver um fornecedor com o mesmo nmero, em locais diferentes. Para capturar todos os
registros para esse fornecedor, no importando a localizao, voc pode selecionar os
campos de localizao e de fornecedor como campos-chave. Voc teria, ento, que
selecionar dois campos-chave correspondentes no arquivo secundrio tambm.
Antes de usar Associar, voc deve ordenar o arquivo secundrio em ordem crescente
pelos campos-chave alfanumricos. Embora no obrigatrio, tambm recomendvel
que voc ordene o arquivo primrio pelos campos-chave. Voc pode fazer isso selecionando a caixa de verificao Pr-ordenar, na caixa de dilogo Associar. Tambm
possvel indexar o arquivo primrio em vez de orden-lo.
222
Manual de Referncia
Voc pode usar Associar com um arquivo primrio no-ordenado, mas, para associaes muito grandes, o tempo de processamento aumenta dramaticamente. Se o
arquivo primrio estiver parcialmente ordenado pelo campo-chave, como acontece
quando um campo ordenado por cdigo de conta por meses individuais, o tempo de
processamento aumenta, mas no muito.
Os campos-chave devem ser campos de caracteres. Seu comprimento deve ser o mesmo
nos arquivos primrio e secundrio. Se os campos no forem idnticos, voc pode usar
vrias funes do ACL, como STRING( ), DATE( ) e SUBSTRING( ), para converter
campos de um tipo de dados em outro e para modificar suas estruturas, tornando-as
adequadas para o uso como campos-chave.
Para converter campos numricos no formato de caractere, consulte STRING( ) na
pgina 80. Consulte tambm Construtor de expresses na pgina 275 do
Guia do Usurio do ACL para Windows e Captulo 2: Funes para obter mais informaes sobre outras alteraes que queira fazer.
Parmetros
Alm dos parmetros descritos abaixo, o comando Join (Associar) tem os seguintes
parmetros: All (Tudo), Append (Anexar a um arquivo existente), First (Primeiros), If
(Se), Local (Local), Next (Prximo), To (Para), Use Output File (Usar arquivo de sada),
While (Enquanto). Para uma descrio desses parmetros, consulte o Captulo 3:
Parmetros de comandos comuns.
Captulo 4
Comandos
Join (Associar)
223
Matched Records: All Primary and All Secondary (Registros correspondentes: todos primrios e
todos secundrios)
Inclui todos os registros dos arquivos primrio e secundrio no arquivo de sada.
Presort (Pr-ordenar)
Ordena o arquivo primrio pelas chaves primrias, antes de associar os arquivos. A
pr-ordenao no pode ser usada em um grupo.
224
Manual de Referncia
Exemplo 1
Esse exemplo mostra como associar registros correspondentes de um arquivo de contas
a receber e um arquivo de cadastro de clientes, usando a opo Todos primrios. A
combinao das informaes de ambos os arquivos fornece uma base melhor para as
anlises de transaes e preparao de cartas de confirmao.
O arquivo primrio o arquivo do contas a receber. O arquivo secundrio o arquivo de
cadastro de clientes. O arquivo de sada associado chamado de Join_ar_customer.
Antes de associar os arquivos, ordene-os por nmero de cliente, nomeando-os
Ar_sort e Customer_sort, respectivamente.
Para associar Ar_sort e Customer_sort:
1. Primeiro exiba a caixa de dilogo Associar. Para faz-lo, abra o arquivo primrio
Ar_sort e selecione Dados na barra de menus e escolha Associar.
2. Em seguida, selecione o arquivo secundrio Customer_sort na lista suspensa
Arquivo secundrio.
Captulo 4
Comandos
Join (Associar)
225
226
Manual de Referncia
Exemplo 2
Este exemplo mostra como procurar por registros no-correspondentes usando os
mesmos arquivos primrio e secundrio, campos-chave, e campos primrios e secundrios, como no Exemplo 1. Registros no-correspondentes significam erros em
potencial nos arquivos.
Siga o Exemplo 1, mas dessa vez nomeie o arquivo Join_ar_customer_no_matches e na
guia [Mais] selecione Registros no-corresp.
Clique em [OK] para executar esse comando e exibir o arquivo de sada. Como no h
correspondente no arquivo do cliente para o cliente nmero 535189, os campos de
nome do cliente e estado no aparecem no arquivo associado. A ausncia de correspondncia para esse nmero de registro pode demandar uma investigao futura.
Captulo 4
Comandos
List (Listar)
227
Voc tambm pode adicionar qualquer uma dessas opes ao formato da sintaxe:
<FIELDS> lista-de-campos-primrios
<PRESORT>
WITH lista-de-campos-secundrios
<IF teste> <WHILE teste> <FIRST|NEXT intervalo>
TO criar-nome-de-arquivo
PKEY lista-de-campos-chave-primrios
SKEY lista-de-campos-chave-secundrios
<OPEN>
<APPEND>
<MANY>
MANY permite que voc execute uma associao um-para-muitos quando existe uma
List (Listar)
Use o comando Listar para exibir dados de sada selecionados em formato de lista por
coluna. Por exemplo, voc pode usar Listar para analisar o contedo detalhado de um
arquivo de entrada.
Este comando s pode ser executado no modo comando. Para obter mais informaes,
consulte Grupos na pgina 340 do Guia do Usurio do ACL para Windows.
Este comando permite que voc selecione informaes do arquivo de entrada e
apresente na tela, envie diretamente para a impressora ou salve em um arquivo de texto.
A menos que seja especificado de outra forma, a sada enviada somente para a tela.
Voc pode incluir o parmetro Linha opcional para criar listagens de vrias linhas.
Os nmeros de pgina, data, hora, identificao do usurio e os ttulos de coluna so
fornecidos automaticamente. As colunas numricas tambm so totalizadas automaticamente. Voc pode especificar o uso de vrias linhas, bem como cabealhos e rodaps
centralizados por meio dos parmetros Cabealho e Rodap.
228
Manual de Referncia
Como os ttulos de coluna so determinados pela primeira linha de campos, certifique-se de especificar os cabealhos apropriados na primeira linha. Use o modificador
Width apropriado para controlar o posicionamento horizontal em cada linha e garantir
que os campos estejam alinhados verticalmente como deseja.
Nota: A organizao de uma Exibio uma forma mais poderosa de listar e analisar
dados do arquivo de entrada.
Consulte Apresentar uma exibio na pgina 196 do Guia do Usurio do
ACL para Windows para obter mais detalhes.
Parmetros
Alm dos parmetros descritos abaixo, o comando List (Listar) tem os seguintes
parmetros: All (Tudo), End Of File (Fim do Arquivo), Footer (Rodap), Header
(Cabealho), To (Para). Para a descrio desses parmetros, consulte o Captulo 3:
Parmetros de comandos comuns.
Fields (Campos)
Indica que os campos que sucedem esta palavra-chave devem ser includos na linha um
da lista.
Line (Linha)
Especifica linhas adicionais de sada.
Para relatrios de linhas mltiplas, os ttulos de coluna so determinados pela linha 1.
Os cabealhos para outras linhas no sero enviados para a sada. Se necessrio, ajuste
os cabealhos na linha 1, de modo a refletir as informaes nas outras linhas.
Skip (Ignorar)
Faz com que o ACL insira o nmero especificado de linhas em branco entre cada
registro da lista. Por exemplo, LIST ALL SKIP 1 produz uma lista com espaamento
duplo (uma linha em branco entre cada registro).
Nota: Ao criar um relatrio de vrias linhas, voc pode usar modificadores de campo, tais
como Largura e Como, para alinhar colunas e ajustar cabealhos.
Consulte Modificadores de campo na pgina 261 do Guia do Usurio do
ACL para Windows para obter mais detalhes.
Captulo 4
Comandos
List (Listar)
229
expresso pode ser utilizado(a). Digite All para listar todos os campos definidos.
Quando usado com o parmetro LINE, campos-da-listagem especifica os campos ou
expresses a serem listados naquela linha.
LINE n pode ser um valor entre 2 e 60.
Exemplo
Este exemplo lista os campos selecionados para os registros que satisfazem a uma
condio especificada.
Voc pode usar o comando List (Listar) em um arquivo de estoque, para listar os
campos referentes a nmero de produto, descrio de produto, quantidade disponvel,
custo unitrio e valor registrado para os registros com custo unitrio ou quantidade
disponvel negativa. Voc tambm pode incluir um cabealho descritivo na lista.
Informe o seguinte na caixa de texto do Log de comando:
LIST PRODNO PRODDESC QTYOH UNCST VALUE IF QTYOH < 0 OR UNCST
< 0 HEADER VALORES NEGATIVOS
230
Manual de Referncia
O ACL informa que somente cinco registros atenderam ao teste. Trata-se de itens
incomuns que merecem investigao futura.
Locate (Buscar)
Use o comando Buscar para mover-se a um nmero de registro especificado ou para o
primeiro registro de um arquivo que satisfaa a uma determinada condio.
Nota: O comando Buscar corresponde s opes Localizar registro e Localizar se do
comando Pesquisar. Para acessar o comando Pesquisar, selecione Analisar na barra de
menus e escolha Pesquisar. Para obter mais informaes, consulte Search (Pesquisar) na
pgina 291.
O comando Buscar geralmente muito mais lento na localizao de um registro
especfico que a opo Localizar literal, do comando Pesquisar, j que Buscar l o
arquivo seqencialmente. Contudo, ao contrrio da opo Localizar literal, Localizar
no exige que o arquivo seja indexado primeiro. A pesquisa sempre se inicia pelo
primeiro registro (a menos que voc especifique os parmetros Enquanto ou Prximo
no comando) e no se baseia em nenhum dos campos-chave predefinidos. A velocidade
de processamento proporcional ao tamanho do arquivo e localizao do registro em
seu interior.
A opo Localizar registro geralmente usada como um modo rpido de mover-se para
um nmero de registro especfico em um arquivo com comprimento de registro fixo.
Voc tambm pode incluir os parmetros Prximo e Enquanto em um comando Buscar.
Captulo 4
Comandos
Locate (Buscar)
231
Parmetros
O comando Locate (Buscar) tem os seguintes parmetros: If (Se), First (Primeiros),
Next (Prximo), Record (Registro), While (Enquanto). Para obter uma descrio desses
parmetros, consulte o Captulo 3: Definir arquivos e campos.
Exemplo
Neste exemplo, voc busca o primeiro registro que satisfaz a uma condio especificada
em um arquivo ordenado.
Para buscar o primeiro item do estoque comeando pela palavra PLYWOOD em um
arquivo ordenado por descrio de produto, use Locate (Buscar). Como o arquivo
ordenado de acordo com a descrio, todos os itens desse tipo so agrupados em
conjunto, facilitando uma anlise rpida dos produtos de madeira compensada.
Digite o seguinte na caixa de texto Log de comando:
LOCATE IF PRODDESC = 'PLYWOOD'
232
Manual de Referncia
Loop
Utilize o comando Loop no comando Grupo para processar um registro mais de uma
vez. Os loops so utilizados com freqncia quando um registro contm informaes
repetidas, s vezes chamadas de buckets ou segmentos, que voc quer processar. Os
comandos entre Loop e End (Fim) so executados repetidamente no registro atual at
que o resultado do teste seja falso.
Os loops podem ser utilizados somente nos grupos. Antes de criar um loop, voc deve
estar familiarizado com os conceitos envolvidos na criao de grupos. Para obter mais
informaes, consulte Group (Grupo) na pgina 198.
Parmetros
O comando Loop tem o seguinte parmetro: While (Enquanto). Para obter uma
descrio, consulte o Captulo 3: Definir arquivos e campos.
Exemplo
Para criar um loop, siga esses passos:
1. Abra um batch. O ACL exibir a janela de batch.
2. Posicione o cursor em um Grupo.
3. Clique em
Captulo 4
Comandos
Loop
233
Exemplo
O comando Loop a seguir totaliza 100 campos repetidos em um registro, supondo-se
que cada um tenha cinco bytes de tamanho:
GROUP
COUNT=0
TOTAL=0
LOOP WHILE COUNT<100
TOTAL=TOTAL+OFFSET(AMOUNT;COUNT*5)
COUNT=COUNT+1
END
END
234
Manual de Referncia
Merge (Mesclar)
Use o comando Mesclar para combinar dois arquivos ordenados, contendo estruturas
de registro idnticas, em um terceiro arquivo. Por exemplo, voc pode usar Mesclar para
combinar dois arquivos contendo estruturas de registro idnticas de diferentes perodos
de tempo, diferentes filiais da empresa e assim por diante.
Para combinar campos de um arquivo de Cadastro e um de Transaes que tenham
estruturas diferentes, consulte Join (Associar) na pgina 218.
Mesclar coloca os registros de sada mesclados de ambos os arquivos primrio e secundrio em um terceiro arquivo de sada. Todos os aspectos dos registros permanecem
inalterados e as seqncias de ordenao so mantidas. Para cada valor do
campo-chave, os registros do arquivo de entrada primrio so posicionados antes dos
registros do secundrio.
Os arquivos de entrada primrio e secundrio devem, necessariamente, ter estruturas
idnticas, embora os campos referentes aos dois arquivos no precisem ter os mesmos
nomes.
O comando Mesclar produz um arquivo de entrada, juntamente com uma definio de
arquivo. Esse novo arquivo pode ser usado para anlise posterior e gerao de relatrio
com o ACL.
Nota: Os parmetros Se, Enquanto, Primeiros e Prximo que limitam registros selecionados para a sada aplicam-se somente ao arquivo de entrada primrio.
Nota: Ao processar arquivos do servidor que contm arquivos relacionados, a sada tipo
registro ser alterada para sada de todos os campos se voc especificar a opo ou a
palavra-chave local.
Consulte Extract (Extrair) na pgina 186 para obter as alternativas possveis.
Pr-requisitos
Para usar a linha de comando, voc precisa abrir o arquivo secundrio, bem como o
primrio, antes de emitir um comando.
Os arquivos primrio e secundrio devem ter, necessariamente, estruturas de registro
idnticas. Do contrrio, os resultados so imprevisveis.
Tanto o arquivo primrio, como o secundrio devem ser ordenados em seqncia
crescente nos campos-chave tipo caractere. Voc pode marcar a caixa de seleo
Pr-ordenar da caixa de dilogo Mesclar para ordenar o arquivo primrio. O arquivo
primrio pode ser indexado em vez de ordenado, se voc desejar. Os campos-chave
devem necessariamente ser campos de caractere. Caso contrrio, utilize a funo
Captulo 4
Comandos
Merge (Mesclar)
235
Parmetros
Alm dos parmetros descritos a seguir, o comando Merge (Mesclar) tem os seguintes
parmetros: All (Tudo), Append (Anexar a um arquivo existente), First (Primeiros), If
(Se), Local (Local), Next (Prximo), To (Para), Use Output File (Usar arquivo de sada),
While (Enquanto). Para obter uma descrio desses parmetros, consulte o Captulo 3:
Parmetros de comandos comuns.
Presort (Pr-ordenar)
Marque a caixa de seleo Pr-ordenar para ordenar o arquivo primrio pelas chaves
primrias, antes de mesclar os arquivos.
236
Manual de Referncia
Exemplo
conveniente ter um livro razo contbil anual atualizado para a anlise das transaes
contbeis. Use o razo geral do primeiro trimestre como o arquivo primrio e o razo
geral do segundo trimestre como o arquivo secundrio.
D a seu arquivo primrio o nome de GLQTR1 e certifique-se de que GLQTR1 e
GLQTR2 sejam ordenados pelo campo de nmero de conta do razo geral. Na caixa de
dilogo Mesclar, selecione GLQTR2 como seu arquivo secundrio e identifique o campo
de nmero de conta como o campo-chave para ambos os arquivos.
O novo arquivo, Gl_jan_to_jun, relaciona (por nmero de conta) todos os registros do
primeiro trimestre, antes daqueles do segundo trimestre. Todos os aspectos dos
registros permanecem inalterados e as seqncias de ordenao so mantidas.
Captulo 4
Comandos
Notify (Notificar)
237
Notify (Notificar)
Use o comando Notificar para enviar arquivos ou informaes sobre o batch em forma
de mensagem ou anexo para endereos de e-mail locais ou remotos. Voc pode enviar a
mensagem para mais de uma pessoa, contanto que seu sistema de e-mail permita vrios
destinatrios.
O comando Notificar funciona com uma variedade de protocolos de e-mail, incluindo
os aplicativos de e-mail VIM para ccMail, MAPI para aplicaes de e-mail da Microsoft
e SMTP para servidores externos.
O comando Notificar um utilitrio exclusivo para envio, no sendo previsto para ser
utilizado como um sistema de correio completo.
Parmetros
O comando Notify (Notificar) tem os seguintes parmetros: Mailbox (Caixa Postal),
Address (Endereo), Message (Mensagem), Password (Senha), User (Usurio).
Address (Endereo)
Especifica os nomes dos destinatrios de e-mails locais e remotos. Separe os nomes e
endereos de vrios destinatrios com uma vrgula.
238
Manual de Referncia
Message (Mensagem)
Especifica o texto da mensagem.
Nota: Se voc estiver utilizando uma aplicao de e-mail da Microsoft, verifique se ela
est ativo antes de iniciar o batch. Caso contrrio, ser exibida uma mensagem do
Windows solicitando a seleo de um perfil de e-mail. Isto pode fazer com que o batch seja
interrompido.
Password (Senha)
Especifica sua senha para e-mails locais.
User (Usurio)
Especifica seu nome de usurio para um sistema local ou seu endereo de e-mail para
um servidor SMTP.
E-mail local
Especifique uma caixa de correio local na caixa de texto Caminho da caixa postal.
Separe vrios destinatrios com uma vrgula.
Clique em [Procurar] para selecionar um arquivo ou batch para adicionar mensagem.
Captulo 4
Comandos
Notify (Notificar)
239
E-mail remoto
Especifique o endereo do servidor SMTP na caixa de texto Caminho da caixa postal.
Separe vrios destinatrios com uma vrgula.
Clique em [Procurar] para selecionar um arquivo ou batch para adicionar mensagem.
240
Manual de Referncia
Open (Abrir)
Use o comando Abrir para abrir um novo arquivo de entrada. O ACL usar a extenso
de arquivo .fil, se nenhuma outra extenso for especificada.
Nota: A janela Viso geral a melhor maneira de abrir um arquivo de dados. Voc
tambm pode selecionar Dados na barra de menu e escolher Selecionar. A abertura de um
arquivo de dados usando qualquer um desses mtodos mais prtica que a emisso do
comando Abrir.
Se o arquivo tiver uma extenso .dbf ou se voc especificar a opo dBASE na sintaxe do
comando, o ACL ir considerar o arquivo como sendo um arquivo de entrada dBASE e
ir ler a definio de arquivo de entrada diretamente a partir do mesmo. O ACL detecta
automaticamente e se ajusta de acordo com as diferenas entre as vrias verses do
dBASE.
Se um arquivo de entrada j estiver aberto o ACL fechar automaticamente o arquivo
antes de executar este comando.
Parmetros
O comando Open (Abrir) tem os seguintes parmetros: Bufferlength (Comprimento do
buffer), CRLF, dBASE, Tape (Fita), Format (Formato), Skip (Ignorar), Index (ndice),
Relation (Relacionamento), Secondary (Secundrio).
Captulo 4
Comandos
Open (Abrir)
241
CRLF
Indica que um arquivo ASCII de comprimento varivel deve ser lido. O ACL se ajusta
automaticamente s variaes de comprimento de registro. Padro: Arquivo de comprimento fixo.
dBASE
Indica que os dados de entrada so de um arquivo dBASE. O ACL reconhece o tipo do
Arquivo dBASE (dBASE II, III, III+, IV, etc.) e cria automaticamente uma definio de
arquivo de entrada, a partir da descrio do arquivo.
Voc pode extender as definies de campo do dBASE com os campos calculados do
ACL.
Esse parmetro usado para arquivos com extenso .dbf. Padro: Arquivo no-dBASE.
Format (Formato)
Especifica a definio de arquivo de entrada (conforme exibida na janela Viso geral) a
ser associado ao arquivo de dados especificado.
Index (ndice)
A opo ndice indica que um arquivo de ndice dever ser aberto para acessar o arquivo
em ordem lgica, em vez de fsica. A extenso de arquivo usada para o nome de arquivo
de ndice .inx, quando no for especificada nenhuma extenso. Voc no pode especificar ndice com arquivos secundrios. Padro: Nenhum arquivo de ndice.
Relation (Relacionamentos)
Indica que o arquivo dever ser aberto como um arquivo relacionado especial. O ACL
no mantm o relacionamento para arquivos relacionados especiais. Voc deve especificar ndice com arquivos relacionados.
Secondary (Secundrio)
Indica que deve ser aberto um arquivo secundrio, em vez do arquivo primrio. Voc
no pode especificar Secundrio em conjunto com ndice ou Fita.
Padro: Primrio.
242
Manual de Referncia
Skip (Ignorar)
Indica que um determinado nmero de bytes ser ignorado no incio fsico do arquivo.
O comando Ignorar pode ser usado para ignorar registros do cabealho do arquivo ou
pores do incio do arquivo que no seguem o layout do restante do mesmo.
Padro: 0.
Tape (Fita)
Indica que h uma unidade de fita ou cartucho anexada que deve ser lida. Voc no pode
emitir Abrir fita como um arquivo secundrio. Consulte Apndice B: Trabalhar com
fita para obter detalhes sobre como abrir um arquivo armazenado em uma fita
magntica.
Exemplo 1
Para abrir um arquivo de entrada do contas a receber, Ar, use Open (Abrir). Digite
OPEN AR na caixa de texto do Log do comando.
Captulo 4
Comandos
Password (Senha)
243
Exemplo 2
Para abrir uma definio de arquivo de entrada Ar, mas associ-lo a um novo arquivo de
dados denominado Cutoff.fil, digite OPEN CUTOFF.FIL FORMAT AR na caixa de
texto do Log do comando.
Exemplo 3
Para abrir o arquivo dBASE denominado Test.dbf no acessado anteriormente, digite
OPEN TEST.DBF na caixa de texto do Log de comando.
Password (Senha)
Muitos arquivos ODBC so protegidos por senha. Use o comando Senha para solicit-la
ao usurio e poder importar ou atualizar arquivos de dados que exijam senhas.
Este comando s pode ser executado no modo de comandos. Esse o mtodo preferido
para solicitar senhas de usurio em batches.
A senha digitada pelo usurio exibida como asteriscos (*) na caixa de dilogo. A senha
real nunca exibida nem registrada no Log de comando e fica acessvel apenas aos
comandos Importar e Atualizar.
O comando Senha bastante til nos batches, de forma que voc pode obter as senhas
necessrias para importar ou atualizar tabelas de banco de dados ODBC antes de
analis-las. possvel armazenar at cinco senhas em um arquivo batch. Para obter mais
informaes, consulte Set Echo (Definir eco) na pgina 305.
Exemplo
Use o comando Password (Senha) seguido do comando Import (Importar) para
importar um arquivo de dados protegido por senha:
PASSWORD 1 "Digite a senha da folha de pagamento:"
IMPORT PAYROLL.FIL PASSWORD 1
244
Manual de Referncia
Pause (Pausa)
Use o comando Pausa para criar uma mensagem personalizada, como uma mensagem
de erro ou explicao de entrada. A mensagem aparece em uma caixa de dilogo.
Nota: Pausa til para exibir uma mensagem ou aviso durante a execuo de um batch.
O comando Pausa no deve ser aplicado registro a registro, portanto no pode ser includo
em um grupo.
Este comando s pode ser executado no modo de comando. Para obter mais informaes, consulte Usar comandos na pgina 260 do Guia do Usurio do
ACL para Windows.
Parmetros
O comando Pause (Pausa) tem o seguinte parmetro: If (Se). Para obter uma descrio,
consulte o Captulo 3: Parmetros de comandos comuns.
Exemplo
Para exibir uma mensagem para o usurio em um batch, digite o seguinte comando na
caixa de texto do Log do comando:
PAUSE 'A classe do produto deve ser um valor de 2 dgitos.'
Captulo 4
Comandos
Profile (Perfil)
245
Profile (Perfil)
Use o comando Perfil para fornecer estatsticas resumidas sobre um ou mais campos
numricos em um arquivo de entrada.
O comando Perfil fornece as seguintes informaes sobre campos numricos:
Valor total
Valor absoluto
Valor mnimo
Valor mximo
Parmetros
Alm dos parmetros descritos a seguir, o comando Profile (Perfil) tem os seguintes
parmetros: All (Tudo), First (Primeiros), If (Se), Next (Prximo), While (Enquanto).
246
Manual de Referncia
Exemplo
Use Perfil para obter o valor absoluto de um campo de valor de estoque. Voc pode em
seguida usar esse valor como sendo o tamanho da populao padro referente a uma
amostra por unidade monetria (MUS) aleatria, no campo.
Captulo 4
Comandos
Profile (Perfil)
247
248
Manual de Referncia
Quit (Sair)
Use o comando Sair para finalizar uma sesso do ACL.
Este comando s pode ser executado no modo de comandos. Para obter mais informaes, consulte Usar comandos na pgina 260 do Guia do Usurio do
ACL para Windows.
Todos os arquivos abertos so salvos e fechados antes de encerrar. Se voc alterou a
exibio atual ou um batch aberto e no salvou as alteraes, o ACL exibir uma
mensagem perguntando se deseja salvar as alteraes antes de sair.
Captulo 4
Comandos
Random (Aleatrio)
249
Este comando particularmente til quando voc deseja ter um batch que saia do ACL
quando concludo.
Nota: Voc pode sair de uma sesso do ACL selecionando Arquivo, na barra de menus e
escolhendo Sair, o que mais prtico que emitir o comando Sair.
Consulte Sair do ACL na pgina 57 do Guia do Usurio do ACL para Windows para
obter mais detalhes.
Random (Aleatrio)
Use o comando Aleatrio para gerar nmeros aleatrios a serem usados em outros
programas que no o ACL.
O comando Aleatrio gera a quantidade especificada de nmeros inteiros aleatrios, a
partir de uma determinada faixa de valores e os exibe em colunas. Voc pode fazer com
que o ACL selecione apenas valores nicos (isto , sem duplicatas) e exiba os nmeros
aleatrios em ordem crescente.
Cada nmero aleatrio gerado ser maior ou igual ao valor mnimo e menor que o valor
mximo especificado. Nenhum nmero aleatrio igual ao valor mximo. Por exemplo,
se voc especificar 0 como nmero mnimo e 100 como nmero mximo, o ACL ir
gerar nmeros aleatrios que variam de 0 a 99.
Parmetros
Alm dos parmetros descritos a seguir, o comando Random (Aleatrio) tem os
seguintes parmetros: As (Como), File (Arquivo), File Type (Tipo de arquivo), Footer
(Rodap), Header (Cabealho), Local (Local), Name (Nome), Screen (Tela), To (Para).
Para obter uma descrio desses parmetros, consulte o Captulo 3: Parmetros de
comandos comuns.
Columns (Colunas)
Especifica o nmero de colunas a ser usado para exibir os nmeros. Digite um nmero
ou use setas para aumentar ou diminuir o nmero mostrado. Padro: 6.
250
Manual de Referncia
Maximum (Mximo)
Especifica o limite superior do intervalo para gerao dos nmeros aleatrios.
permitido o uso de qualquer expresso ou valor numrico vlido. Os valores Mximo e
Mnimo devem ser especificados juntos.
Minimum (Mnimo)
Especifica o limite inferior do intervalo de gerao dos nmeros aleatrios. permitido
o uso de qualquer expresso ou valor numrico vlido. Os valores Mnimo e Mximo
devem ser especificados juntos.
Number (Nmero)
Especifica a quantidade de nmeros aleatrios a serem gerados. Digite um nmero.
Seed (Origem)
Especifica o ponto de partida para o gerador de nmeros aleatrios. Se um comando
Aleatrio for duplicado com o mesmo valor de origem, a seqncia de nmeros
aleatrios ser identicamente reproduzida. O ACL substitui um valor zero de origem
por um nmero aleatrio. Padro: Gerado internamente.
Sorted (Ordenado)
Faz com que a lista de nmeros de sada seja apresentada em ordem crescente. Padro:
No ordenado.
Unique (Exclusivo)
Faz com que somente nmeros exclusivos sejam includos na sada. Quando voc
seleciona Exclusivo, cada nmero aleatrio gerado comparado com a lista inteira de
nmeros anteriores gerados para esse comando. Se for uma repetio, o nmero
descartado sem substituio.
Voc no deve selecionar Exclusivo quando a quantidade de nmeros aleatrios a serem
gerados excede 75% do intervalo, j que isso pode fazer com que uma quantidade
excessiva de nmeros seja descartada. Padro: Duplicaes permitidas.
Captulo 4
Comandos
Random (Aleatrio)
251
Exemplo
Para gerar 10 nmeros aleatrios exclusivos entre 1 e 1000, ordenados em seqncia
crescente, em duas colunas, use Aleatrio.
252
Manual de Referncia
Refresh (Atualizar)
Use Refresh para atualizar arquivos planos criados por ocasio da importao de dados
de uma fonte externa.
Em um lote, voc pode atualizar e ento analisar o arquivo, como faria com qualquer
outro arquivo de dados. Consulte Import (Importar) na pgina 210 para obter
detalhes.
O comando Refresh substitui apenas o arquivo de dados associado e no atualiza
automaticamente as definies de campo. O comando Refresh supe que o formato do
arquivo-fonte seja idntico ao de quando foi originariamente definido no
ACL para Windows. Se este no for o caso, voc deve importar os dados novamente.
Parmetros
O comando Refresh (Atualizar) tem o seguinte parmetro: Password (Senha).
Captulo 4
Comandos
Relations (Relacionamentos)
253
Password (Senha)
Se voc precisar de uma senha para atualizar dados de uma origem externa, use o
comando Password. Consulte Password (Senha) na pgina 243 para obter detalhes.
(Atualizar a partir do
Relations (Relacionamentos)
O comando Relacionamentos permite acessar e analisar simultaneamente os dados de
dois ou mais arquivos, dois arquivos por vez. Voc pode analisar os dados combinados
como se existissem em um arquivo nico e adicionar campos a partir dos arquivos
relacionados a uma exibio.
Como voc est trabalhando com dados de arquivos diferentes, pode utilizar o
comando Relacionamentos para examinar os relacionamentos previstos e descobrir
alguns no esperados. Alm disso, pode criar um novo arquivo contendo os campos de
dados relacionados, utilizando o comando Extrair. O comando Relacionamentos
produz resultado similar ao do comando Associar com a opo Todos primrios selecionada.
Dois arquivos a serem relacionados devem ter um campo-chave comum. O
campo-chave deve ser um campo de caractere que contm o mesmo tipo de dados.
Todos os arquivos relacionados devem ser definidos no mesmo Projeto ACL.
254
Manual de Referncia
Captulo 4
Comandos
Relations (Relacionamentos)
255
arquivos a serem relacionados e seus ndices devem estar no mesmo servidor. Voc no
pode relacionar um arquivo da unidade local com um arquivo do servidor.
Antes de relacionar dois arquivos, voc deve:
Eles tambm podem ser campos calculados. Ou seja, voc pode criar um campo
calculado para funcionar como o campo-chave.
Normalizar campos-chave
Os campos-chave, tanto nos arquivos pai, como nos arquivos filho, devem ser campos
de caracteres ou expresses, com estrutura idntica. s vezes necessrio modificar ou
normalizar o contedo de um campo antes de us-lo como campo-chave. Voc pode
utilizar funes do ACL para converter campos no formato de caractere e modificar seu
contedo.
Voc pode utilizar funes no Construtor de expresses, tais como STRING( ) ou
DATE( ), para converter campos para o formato de caractere. Consulte Construtor de
expresses na pgina 275 do Guia do Usurio do ACL para Windows para obter mais
detalhes. Outras funes permitem combinar dois campos em um, diminuir campos ou
modificar a estrutura de vrias maneiras, para fazer com que se adaptem para serem
utilizadas como campos-chave.
Por exemplo, em um arquivo, o campo do nmero do cliente pode ser numrico. Voc
pode criar um novo campo calculado para ser o campo-chave e utilizar a funo
256
Manual de Referncia
Captulo 4
Comandos
Relations (Relacionamentos)
257
Ar (arquivo pai)
No
No do cliente
Customer
Number
do pedido
Data do pedido
Nome do cliente
No do cliente
Endereo
No
Limite de crdito
do contrato
Quantia do pedido
Arquivos a
serem
comparados
Contract (arquivo filho)
No
No do representante.
do contrato
Data do contrato
Nome do representante.
Tipo de contrato
Endereo
No
Vendas YTD
do representante.
258
Manual de Referncia
mento entre esses dois arquivos. Esse relacionamento proporciona acesso a todos os
campos no arquivo Ar, bem como aos campos pertinentes no arquivo Customer: Nome
(NAME) e Limite de Crdito (LIMIT).
Depois de estabelecido um relacionamento entre os dois arquivos, voc pode acessar os
campos Nome do Cliente (NAME) e Limite de Crdito (LIMIT) nos comandos que voc
emitir, a partir do arquivo Ar pai. Se quiser, tambm pode adicionar esses campos
exibio do arquivo Ar.
Ambos os arquivos relacionados Cdigo do cliente como campo-chave
Ar (arquivo pai)
Voc pode adicionar campos a partir do arquivo Customer, na exibio do arquivo Ar.
Captulo 4
Comandos
Relations (Relacionamentos)
259
Agora voc pode utilizar o campo Cdigo do vendedor para relacionar o arquivo Ar ao
arquivo Sales Rep e adicionar o campo Nome do vendedor exibio do arquivo Ar.
Agora todos os campos de interesse esto na exibio do arquivo pai Ar e podem ser
analisados como se estivessem no prprio arquivo.
Nota: Voc pode trabalhar com campos a partir dos arquivos relacionados, estejam eles
adicionados ou no exibio do arquivo pai. Depois que os relacionamentos so estabelecidos, todos os campos relacionados ficam disponveis para anlise, a partir do arquivo
pai e aparecem nas listas de seleo de campos nos comandos e no Construtor de
expresses.
Parmetros
Alm dos parmetros descritos a seguir, o comando Relations (Relacionamentos) tem o
seguinte parmetro: As (Como). Para obter uma descrio, consulte o Captulo 3:
Definir arquivos e campos.
OK
O ACL executa o comando sem solicitao. Caso contrrio, o ACL solicita que voc
aceite ou cancele a excluso do relacionamento especificado.
260
Manual de Referncia
Pai
Filho
Campo-chave
Nome do
Relacionamento
Ar
Customer
Cdigo do Cliente
Customer
Ar
Customer
Novo campo-chave
Customer 2
Relationships (Relacionamentos)
Exibe detalhes dos relacionamentos referentes ao arquivo aberto. Por exemplo, a caixa
de listagem Relacionamentos acima mostra que no existem relacionamentos. Os
detalhes dos relacionamentos do arquivo aberto so organizados para mostrar nome
do arquivo relacionado relacionado ao nome do campo, utilizando o ndice nome
do arquivo ndice. Esses detalhes indicam a origem de todos os campos.
Captulo 4
Comandos
Relations (Relacionamentos)
261
Relacionamento de arquivos
Para relacionar dois arquivos:
1. Abra o arquivo Ar clicando duas vezes no nome do arquivo na janela Viso geral ou
arrastando-o da janela Viso geral para a rea de trabalho do aplicativo.
262
Manual de Referncia
Captulo 4
Comandos
Relations (Relacionamentos)
263
264
Manual de Referncia
4. Na caixa de listagem Campos disponveis, clique duas vezes no campo que deseja
ordenar e, em seguida, clique na seta direita para mover o campo para a caixa de
listagem Campos selecionados.
5. Clique em [OK] para voltar caixa de dilogo Ordenar, na qual voc pode executar
o comando de maneira normal. Para obter mais informaes, consulte Sort
(Ordenar) na pgina 317.
Captulo 4
Comandos
Relations (Relacionamentos)
265
266
Manual de Referncia
Excluir relacionamentos
Voc pode excluir qualquer relacionamento que no tenha relacionamentos dependentes, e nenhum campo relacionado na exibio atual ou em um campo calculado
ativo.
Captulo 4
Comandos
Relations (Relacionamentos)
267
Exemplo
1. Abra a exibio padro do arquivo do qual voc deseja excluir o relacionamento.
Selecione Dados na barra de menus e escolha Relacionamentos para exibir a caixa
de dilogo Relacionamentos.
268
Manual de Referncia
Define (Definir)
Esta a verso do modo de comando do comando Relacionamentos, na barra de menus.
Ela permite criar um relacionamento entre um arquivo pai e um filho por um
campo-chave comum, utilizando um ndice especificado para o arquivo filho.
DEFINE RELATION nome-do-campo-chave WITH
nome-do-arquivo-relacionado INDEX nome-do-ndice <AS
nome-do-relacionamento>
nome-do-relacionamento permite especificar um novo nome do relacionamento
para poder criar um outro relacionamento com o mesmo arquivo.
Delete (Excluir)
Este comando permite excluir qualquer relacionamento que no tenha relacionamentos
dependentes e nenhum campo relacionado na exibio atual ou em um campo
calculado ativo.
DELETE RELATION
Display (Exibir)
Este comando permite visualizar os detalhes dos relacionamentos do arquivo atual, da
mesma forma que voc visualizaria na caixa de listagem Relacionamentos, da caixa de
dilogo Relacionamentos. O ACL utiliza o formato nome-do-arquivo-relacionado relacionado por nome-do-campo-chave utilizando o ndice chamado nome-do-ndice.
DISPLAY RELATION
Por exemplo:
Customer relacionado por No utilizando ndice Customer_index.
Captulo 4
Comandos
Rename (Renomear)
269
Como este um relacionamento temporrio, ele deixa de existir quando voc fecha
qualquer um dos arquivos. Alm disso, no se pode utilizar o comando Display Relation
(Exibir relacionamentos) para visualizar os detalhes dos relacionamentos temporrios
assim criados. O comando Display Relation exibe apenas os detalhes dos relacionamentos permanentes.
DISPLAY RELATION
Rename (Renomear)
Use o comando Renomear para alterar o nome de um campo, arquivo ou objeto contido
no Projeto ACL.
Este comando s pode ser executado no modo de comando. Para obter mais informaes, consulte Usar comandos na pgina 260 do Guia do Usurio do
ACL para Windows.
Voc pode rapidamente renomear quaisquer itens que compem um Projeto ACL (por
exemplo, um arquivo de entrada ou um batch) selecionando o nome do item na janela
Viso geral e clicando em
(Renomear).
Para usar o comando Renomear para renomear um dos itens que compem um Projeto
ACL, necessrio especificar o parmetro apropriado (por exemplo, BATCH) no
comando. Consulte a segunda variao da sintaxe do comando Renomear, a seguir.
Voc no pode renomear um campo que esteja includo na exibio atual ou na
definio de um campo calculado. Tambm no possvel renomear um arquivo de
entrada que esteja atualmente em uso.
Voc tambm pode renomear campos utilizando a janela Definio de arquivo de
entrada, conforme descrito em Manteno das Definies dos arquivos de entrada na
270
Manual de Referncia
pgina 184 do Guia do Usurio do ACL para Windows. Tambm possvel renomear
arquivos de entrada na caixa de dilogo Selecionar arquivo de entrada, conforme
descrito em Caixas de dilogo selecionar/editar na pgina 40 do Guia do Usurio do
ACL para Windows. A renomeao feita atravs da caixa de dilogo Selecionar arquivo
de entrada renomeia a definio de arquivo de entrada, mas no o arquivo de dados ao
qual est vinculado.
Pr-requisitos
Os campos a serem renomeados no podem estar includos na exibio atual nem ser
referenciados por uma definio de campo calculado.
Os arquivos que sero renomeados no podem estar abertos e o novo nome no pode
ser igual ao nome do arquivo existente.
Os arquivos a serem renomeados no podem estar abertos.
Parmetros
Alm dos parmetros descritos a seguir, o comando Rename (Renomear) tem os
seguintes parmetros: As (Como), File (Arquivo), To (Para). Para obter uma descrio,
consulte o Captulo 3: Definir arquivos e campos.
Batch, Format (Formato), Index (ndice), Report (Relatrio), Workspace (rea de trabalho)
Especificam o tipo de item a ser renomeado.
Field (Campo)
Permite renomear um campo.
OK
Indica que o processo de renomeao pode prosseguir sem confirmao.
Captulo 4
Comandos
Rename (Renomear)
271
Exemplo 1
Sempre que possvel, um nome de campo deve descrever seu contedo. Se um campo
no tiver sido nomeado apropriadamente, voc pode usar Rename (Renomear) para
alterar o nome.
Em um arquivo de transaes de vendas, para renomear o campo do nmero da fatura
de ProdNo para Product, use o comando Rename. Certifique-se de que Comandos
esteja selecionado na caixa de listagem suspensa do Log do comando e digite o seguinte:
RENAME FIELD PRODNO AS PRODUCT
Voc ser solicitado a confirmar se est seguro de que deseja renomear o campo.
272
Manual de Referncia
Exemplo 2
Para renomear um batch Ar June sem solicitao de confirmao, digite RENAME
BATCH ARJUN TO AR06 OK na caixa de texto do Log de comando.
Report (Relatrio)
Use o comando Relatrio para imprimir um relatrio e para especificar opes de
impresso. Voc tambm pode especificar um arquivo HTML (HyperText Markup
Language) como a sada do relatrio. Todos os navegadores da Web podem ler arquivos
no formato HTML. Isso permite que voc prepare os relatrios ACL para serem distribudos ou publicados na World Wide Web. O ACL gera arquivos HTML no formato
HTML 3,0.
Nota: Como a maioria das sadas dos relatrios do ACL est no formato de tabela, para
visualizar os dados de sada necessrio um navegador da Web que suporte tabelas, como
o Netscape 3 ou mais recente, Internet Explorer 3 ou mais recente.
Um relatrio baseado em uma exibio. Opcionalmente, voc pode usar a verso de
linha de comando para formatar um relatrio. A linha de comando no tem acesso a
certos recursos avanados, como fontes.
H trs passos bsicos para criar um relatrio formatado:
1. Abrir uma exibio e especificar a formatao de campos que se deseja para o
relatrio.
2. Abrir a caixa de dilogo Relatrio e especificar o layout da pgina e do relatrio.
3. Imprimir o relatrio.
Utilize as opes disponveis na caixa de dilogo Relatrio para o segundo e terceiro
passos da criao de um relatrio. Voc pode especificar um cabealho e um rodap,
ordenar seu relatrio com base em campos-chave previamente selecionados, produzir
um relatrio sumarizado, ignorando detalhes, e especificar o espaamento entre linhas
e o tamanho da fonte. Voc pode ainda acessar a caixa de dilogo Configurar impresso
do Windows, e escolher entre enviar seu relatrio para a tela, para um arquivo, visualizar a impresso do relatrio ou enviar o relatrio diretamente para a impressora.
Personalizar relatrios
A criao de um relatrio est descrita com detalhes em Imprimir no ACL na
pgina 50 do Guia do Usurio do ACL para Windows. Recomendamos que voc leia o
contedo desta seo antes de usar o comando Relatrio.
Captulo 4
Comandos
Report (Relatrio)
273
Pr-requisitos
necessrio abrir uma exibio antes de selecionar Dados na barra de menu e escolher
Relatrio. A exibio usada para formatar os campos e determinar o layout e o
contedo do relatrio.
Parmetros
Alm dos parmetros descritos a seguir, o comando Report (Relatrio) tem os seguintes
parmetros: Append (Anexar a um arquivo existente), End Of File (Fim do arquivo),
File (Arquivo), File Type (Tipo de arquivo), Footer (Rodap), Graph (Grfico), Header
(Cabealho), If (Se), Local (Local), Name (Nome), Nodups (Suprimir duplicidades),
Nozeros (Branco se for zero), Print (Imprimir), Screen (Tela), Suppress (Suprimir
outros), While (Enquanto). Para obter a descrio desses parmetros, consulte o
Captulo 3: Parmetros de comandos comuns.
Presort (Pr-ordenar)
Faz com que o ACL indexe os campos-chave selecionados, antes de criar um relatrio.
Para selecionar esta opo, voc precisa primeiro selecionar os campos-chave na
exibio, usando o marcador de campo-chave para ordenao. Voc tambm precisa
especificar a seqncia de ordenao para cada campo-chave.
Consulte Imprimir no ACL na pgina 50 do Guia do Usurio do ACL para Windows,
para obter detalhes.
Preview (Visualizar)
Permite visualizar o formato de seu relatrio com a orientao e o tamanho de pgina
que voc especificou na caixa de dilogo Configurar pgina.
Para visualizar a pgina seguinte ou a anterior, clique em [Prximo] ou [Anterior],
respectivamente.
Para ampliar uma rea do seu relatrio, posicione seu cursor sobre a rea da pgina a ser
ampliada e clique. Clique na pgina para diminuir o zoom e visualizar a pgina inteira
novamente.
274
Manual de Referncia
Para pular para a ltima pgina de seu relatrio, clique em [ltima pgina].
Setup (Configurar)
Exibe a caixa de dilogo Configurar pgina se voc selecionou a impressora como sada.
Voc pode selecionar uma impressora, o tamanho e orientao do papel e especificar
vrias outras opes que afetam a forma como seu relatrio impresso.
Summarize (Sumarizar)
Produz um relatrio somente com subtotais e totais, sem linhas de detalhe. Os subtotais
so gerados com base nos campos-chave de quebra selecionados na exibio.
Se esta opo no for selecionada, o ACL produzir um relatrio que inclui linhas de
detalhe, bem como subtotais para cada um dos campos-chave de quebra especificados.
Padro: Incluir linhas de detalhe.
Captulo 4
Comandos
Report (Relatrio)
275
Exemplo 1
Neste exemplo, voc prepara um relatrio.
Aps formatar o contedo do seu relatrio na exibio, use a caixa de dilogo Relatrio
para especificar um cabealho e um rodap, um espaamento entre linhas e todos os
parmetros de configurao da impressora.
Selecione um cabealho e um rodap que descrevam adequadamente o contedo e o
autor do relatrio. Para produzir um relatrio detalhado com espaamento duplo,
selecione Espaamento duplo da lista suspensa.
276
Manual de Referncia
Exemplo 2
Neste exemplo, voc cria um relatrio de linhas mltiplas. Como um relatrio baseado
em uma exibio, voc pode usar o recurso de linhas mltiplas do ACL para reorganizar
sua exibio atual, de modo a aproxim-la do formato de seu relatrio final. Consulte
Criar exibies com multilinhas na pgina 208 do Guia do Usurio do
ACL para Windows para obter mais detalhes.
Captulo 4
Comandos
Report (Relatrio)
277
Nota: Para usar <NODUPS>, <ON> tambm deve ser includo, conforme exibido.
<NODUPS> no funcionar se <ON> no for especificado.
LINE n especifica as linhas de sada adicionais. n pode ser um valor entre 2 e 60. Os
278
Manual de Referncia
Sample (Amostra)
Utilize o comando Amostra para criar uma amostra de registros ou unidades
monetrias (MUS) de uma populao, em um arquivo de entrada.
O comando Amostra suporta uma vasta gama de atividades de amostragem. Voc pode
criar amostras de registros ou monetrias em combinao com um nmero de
parmetros e opes de amostra, para atender suas necessidades.
Nota: A criao de uma sada de registro a partir de um arquivo que contm campos
estticos e/ou estticos condicionais pode produzir resultados imprevisveis. Certifique-se
de selecionar apenas os campos desejados.
Nota: Ao processar arquivos do servidor que contenham arquivos selecionados, a sada do
registro ser alterada para todos os campos, se voc especificar a opo ou palavra-chave
local.
O comando Amostra oferece os seguintes tipos de amostragem:
Amostragem aleatria
Amostragem de intervalo
Tendncia de amostragem
Tendncia de amostragem a probabilidade de seleo atribuda a cada item da
populao. A tendncia varia de acordo com o mtodo de amostragem utilizado.
Amostragem de registros
Uma amostra de registros no tem tendncia. Todos os registros do arquivo tm as
mesmas chances de serem selecionados. Um item de cem dlares tem as mesmas
chances de ser selecionado que um item de um milho de dlares. Portanto, h uma
Captulo 4
Comandos
Sample (Amostra)
279
Limite
Voc pode tambm tendenciar a amostra, incluindo ou excluindo classes inteiras de
transaes ou registros. Voc pode usar Limite para incluir especificamente todas as
transaes acima de um determinado valor. Voc tambm pode especificar uma
condio para uma faixa ampla de testes; por exemplo, excluindo itens da Classe de
Produto 05, ou incluindo somente valores acima de $10.000 para o ms de abril.
Tipo de amostra
Ao selecionar um tipo de amostra, voc est determinando o mtodo especfico a ser
usado para criar a amostra. O comando Amostra oferece os trs mtodos bsicos a
seguir:
280
Manual de Referncia
Amostragem aleatria
Voc pode usar quaisquer outros mtodos por meio de lgica programada, em um
grupo de comandos. Para obter mais informaes, consulte Em batches e grupos na
pgina 261 do Guia do Usurio do ACL para Windows.
Amostragem aleatria
Na amostragem aleatria, voc precisa especificar um valor de origem aleatrio, o
tamanho da populao e o nmero de selees exigidas. O ACL gera a quantidade
exigida de nmeros aleatrios entre um e a populao especificada, com base na origem
aleatria e, em seguida, faz selees usando os nmeros aleatrios.
Captulo 4
Comandos
Sample (Amostra)
281
Uma amostra aleatria pode extrair bem poucas amostras de certos segmentos da
populao. A menos que voc adote procedimentos especficos, as transaes significativas podem ser completamente ignoradas.
Se voc marcar a caixa de seleo Sem repeties para limitar as retiradas sucessivas,
uma amostragem aleatria poder produzir menos selees do que foi solicitado. Em
uma amostragem monetria aleatria, se dois dos nmeros aleatrios gerados forem
prximos, podem tornar-se parte do mesmo registro. Se isso ocorrer, o ACL no ir
selecionar outro item. Para obter mais informaes, consulte Amostragem com e sem
substituio na pgina 390 do Guia do Usurio do ACL para Windows.
Ao executar uma amostra aleatria, voc pode pedir a ordem de seleo dos itens
extrados. Isso til quando voc faz uma superamostragem. Voc s pode solicitar a
ordem de seleo quando faz amostragem aleatria e seleciona a sada de campos, no
do registro inteiro.
Na rea Tipo de amostra da caixa de dilogo, selecione Registro. Na rea Parmetros da
amostra, selecione Aleatrio e digite os valores do Tamanho (da superamostra), da
Origem e da Populao. Na caixa de texto Para, informe o nome do arquivo de sada.
Clique em [Mais].
282
Manual de Referncia
Captulo 4
Comandos
Sample (Amostra)
283
Parmetros
Alm dos parmetros descritos a seguir, o comando Sample (Amostra) tem os seguintes
parmetros: All (Tudo), Append (Anexar a um arquivo existente), First (Primeiros),
Footer (Rodap), Header (Cabealho), If (Se), Next (Prximos), Record (Registro), To
(Para), While (Enquanto). Para obter uma descrio desses parmetros, consulte
Captulo 3: Parmetros de comandos comuns.
Cell (Clula)
Seleciona Clula como o mtodo de amostragem.
Cutoff (Limite)
Especifica uma quantidade para amostragem de Intervalo Fixo e de Clula, acima da
qual um item considerado da camada superior. Os itens de camada superior so
exibidos automaticamente e includos na amostra.
O limite padro o tamanho do intervalo.
284
Manual de Referncia
Fields (Campos)
Permite que voc selecione campos especficos a serem includos no arquivo de sada,
ativando a caixa de listagem Extrair campos.
Interval (Intervalo)
Especifica o valor do intervalo para amostragem de Intervalo fixo e Clula.
MUS
Seleciona a amostragem por unidade monetria como o tipo de amostra.
Population (Populao)
Permite especificar o nmero total de unidades na populao, seja em termos de
registros ou valor absoluto do campo que est sendo amostrado. O valor de uma
populao est somente disponvel para Amostragem aleatria.
Para assegurar-se de que todos os registros ou valores de campo na populao de
amostragem tm igual oportunidade de seleo, use o nmero total de registros no
arquivo ou o valor absoluto do campo usado como amostra, conforme apropriado,
como tamanho da populao.
Se voc escolher algum outro tamanho para a populao, o ACL ir inform-lo na janela
Log de comando que o total da populao fornecida difere do total real.
O padro da amostragem MUS o valor absoluto do campo, se os comandos Perfil ou
Estatsticas foram emitidos anteriormente. Do contrrio, no h padro.
O padro para amostragem de Registros a contagem de registros do arquivo.
Captulo 4
Comandos
Sample (Amostra)
285
Random (Aleatrio)
Seleciona Aleatrio como o mtodo de amostragem. O ACL oferece diferentes
parmetros de amostragem, dependendo de voc ter escolhido os botes de opo
Intervalo fixo, Clula ou Aleatrio.
Record (Registro)
Na guia [Principal]. Seleciona a amostragem por Registro como o tipo de amostra.
Seed (Origem)
Especifica o valor de origem para o gerador de nmeros aleatrios das amostras Clula
e Aleatrio.
Size (Tamanho)
Exibe a caixa de dilogo Tamanho, que voc pode usar para determinar tamanhos
apropriados de amostra para usar com registros e MUS. Informe os valores de
parmetro apropriados e clique em [Calcular] para exibir os resultados. Clique em [OK]
para voltar caixa de dilogo Amostra. Todos os parmetros que voc atribuiu na caixa
de dilogo Tamanho so mantidos.
Consulte Size (Tamanho) na pgina 309 para obter detalhes sobre o uso do comando
Tamanho.
Start (Incio)
Especifica o primeiro registro ou unidade monetria escolhida em uma amostra de
Intervalo fixo.
286
Manual de Referncia
Subsample (Subamostra)
Gera um campo adicional no arquivo de sada, que contm um nmero aleatrio entre
zero e o valor de campo do item selecionado. Isso til quando for necessria uma
subamostragem (por exemplo, onde um item de amostra selecionado composto de
vrios itens menores). Os itens de camada superior tm um valor de Subamostra igual
a zero, facilitando procedimentos de auditoria alternativos nessa populao.
Isso s estar disponvel se voc selecionar sada de campos.
O padro sem subamostragem.
Exemplo 1
Neste exemplo, voc cria uma amostra de unidade monetria (MUS) de intervalo fixo.
A maior parte do trabalho de um auditor realizada em amostras, a partir de uma
populao mais ampla. Use o comando Amostra para criar uma amostra de unidade
monetria (MUS) a partir de um campo de valor de estoque, onde:
Captulo 4
Comandos
Sample (Amostra)
287
288
Manual de Referncia
Use a barra de rolagem para visualizar o arquivo inteiro. Como caracterstico de uma
amostragem MUS, foram selecionados valores monetrios maiores. O registro do
comando mostra uma informao resumida dos resultados.
O tamanho da amostra 24, com zero itens de camada superior. Tambm so exibidos
o total da populao a partir da qual foi criada a amostra, incluindo uma quebra desse
valor entre a camada superior e os demais valores, bem como o ponto inicial de seleo
para a amostra de intervalo fixo.
Exemplo 2
Use o comando Amostra para criar uma amostra aleatria de registros, a fim de determinar a concordncia com um conjunto de procedimentos de aprovao de transaes
de vendas. No teste de concordncia, o valor monetrio dos itens testados nem sempre
relevante; logo, a amostragem por unidade monetria no usada.
Selecione Registro como Tipo de amostra e Aleatrio como Parmetro de amostra. Para
gerar 26 itens distintos para teste, especifique 26 como tamanho de amostra.
Especifique 234 como origem aleatria. O ACL ir listar automaticamente o tamanho da
populao, neste caso, 152. Especifique que o registro inteiro deve ser copiado para o
arquivo de amostra, Ar_sample.
Captulo 4
Comandos
Sample (Amostra)
289
Use a barra de rolagem para visualizar o arquivo inteiro. O Log de comando mostra uma
informao resumida dos resultados da amostragem.
O tamanho da amostra 26, com zero itens de camada superior. Tambm so exibidos
o total da populao a partir da qual foi criada a amostra, incluindo o valor inicial para
a amostra aleatria de registros.
O ACL exibe o tamanho da amostra com o nmero dos itens de camada superior, bem
como o total da populao de onde foi extrada a amostra, inclusive o valor inicial da
amostra aleatria de registros.
Depois de verificar sua amostra, voc pode utilizar o comando Avaliar para avaliar os
dados. Para obter mais informaes, consulte Evaluate (Avaliar) na pgina 176.
290
Manual de Referncia
Save (Salvar)
Use o comando Salvar para armazenar definies de campo do arquivo de entrada atual
em um arquivo de rea de trabalho.
Este comando utilizado somente nas reas de trabalho e apenas no modo de comando.
Para obter mais informaes, consulte Emitir comandos na pgina 267 do
Guia do Usurio do ACL para Windows.
De forma muito semelhante definio de um arquivo de entrada, uma rea de trabalho
um arquivo que armazena definies de campo. Contudo, ela no est associada a um
arquivo de entrada especfico. As reas de trabalho so mais freqentemente usadas
para armazenar campos calculados para serem usados em mais de um arquivo de
entrada. Por exemplo, voc pode aplicar um conjunto de campos calculados para uma
anlise de arquivos de contas a receber, referentes a diferentes perodos e localizaes.
Se a rea de trabalho especificada j existir em seu documento atual, o ACL ir
perguntar se deseja substitu-la.
Para usar o comando Salvar, importante entender como as reas de trabalho operam.
Para obter mais informaes sobre as reas de trabalhos e como cri-las atravs da
janela Viso geral, consulte reas de trabalho na pgina 355 do Guia do Usurio do
ACL para Windows.
Parmetros
O comando Save (Salvar) tem o seguinte parmetro: Workspace (rea de trabalho).
Exemplo
Para salvar os campos calculados GRMargin e PercMarg em uma rea de trabalho
denominada Inventory_margin, que calcula a margem unitria e o percentual da
margem unitria para itens de estoque, use o comando Save (Salvar), conforme descrito
a seguir.
Voc pode ento aplicar esses campos calculados a arquivos de estoque de diferentes
perodos ou divises. Todo campo referenciado pelos campos calculados na rea de
Captulo 4
Comandos
Search (Pesquisar)
291
trabalho deve ter nome idntico em todos os arquivos aos quais a rea de trabalho
aplicada.
Digite SAVE WORKSPACE INVENTORY_MARGIN GRMARG PERCMARG na caixa de
texto do Log de comando.
A rea de trabalho est agora pronta para ser ativada, emitindo-se o comando Activate
(Ativar). Consulte Activate (Ativar) na pgina 120 para obter mais detalhes.
Search (Pesquisar)
Use o comando Pesquisar para localizar:
Uma vez encontrado o registro, voc pode escolher entre realizar clculos com base nele
ou comparar seu contedo ao de um outro registro.
Nota: Se voc estiver usando um arquivo indexado com o comando Pesquisar, dever
saber se o ndice condicional ou no. Um ndice condicional exclui determinados registros
da exibio resultante e dos comandos emitidos quando est em vigor.
Consulte Index (ndice) na pgina 211 para obter mais detalhes.
Consulte tambm Find (Localizar) na pgina 195, Locate (Buscar) na pgina 230 e
Seek (Encontrar) na pgina 297.
Parmetros
O comando Search (Pesquisar) tem os seguintes parmetros: Buscar expresso, Expr,
Localizar literal, Localizar registro, Localizar se.
Expr
Permite que voc informe um nmero de registro ou expresso. Para inserir uma
expresso, digite-a diretamente na caixa de texto ou selecione [Expr] para exibir o
Construtor de expresses, a fim de ajud-lo a criar uma expresso. Consulte
Construtor de expresses na pgina 275 do Guia do Usurio do ACL para Windows
para obter mais detalhes.
292
Manual de Referncia
Captulo 4
Comandos
Search (Pesquisar)
293
Exemplo 1
Para localizar o registro de nmero 478 em um arquivo de contas a receber, use
Pesquisar com a opo Localizar registro.
294
Manual de Referncia
O Log de comando indica que o registro 478 foi localizado e o arquivo est posicionado
naquele registro em sua exibio. Voc pode realizar anlises ou clculos posteriores,
com base em cada registro.
Exemplo 2
Para verificar um arquivo de cadastro de clientes em busca de um registro onde o nome
do cliente Syscom Gas, use a opo Localizar se do comando Pesquisar. Quando
houver mais de uma ocorrncia de Syscom Gas no arquivo, o ACL posicionar o arquivo
na primeira ocorrncia.
Captulo 4
Comandos
Search (Pesquisar)
295
A janela Log de comando indica que condio foi atendida pelo registro 47 e o ACL
posiciona o arquivo naquele registro, em sua exibio.
Exemplo 3
Para visualizar uma lista de clientes com base em Nova York (abrevia-se NY) use a
opo Localizar literal do comando Pesquisar. Certifique-se de que o arquivo est
indexado no campo que representa o local de residncia.
No caso das empresas atuantes em vrios estados, cidades ou pases que tm leis e
normas distintas (por exemplo, para os impostos sobre vendas) til acessar uma lista
de clientes agrupados por local de residncia.
296
Manual de Referncia
Captulo 4
Comandos
Seek (Encontrar)
297
Seek (Encontrar)
Use o comando Encontrar para mover-se diretamente para o primeiro registro em um
arquivo indexado, contendo uma determinada chave de pesquisa de caractere.
Este comando s pode ser executado no modo de comandos. Para obter mais informaes, consulte Emitir comandos na pgina 267 do Guia do Usurio do
ACL para Windows.
O comando Encontrar permite que voc localize o primeiro registro no arquivo de
entrada indexado que possui um valor de chave de ndice igual ou maior que o valor de
uma determinada expresso de caractere. Se o valor de chave especificado for encontrado, a exibio ser posicionada naquele registro. Do contrrio, ser exibida a
mensagem Nenhum ndice corresponde chave e o arquivo ser posicionado no
primeiro registro que tenha um valor de chave maior que o valor especificado.
Aps o registro ser encontrado, voc pode querer exibi-lo ou realizar clculos com base
em seu contedo. Opcionalmente, voc pode comparar o contedo de um registro com
o de outro, ou com o de uma varivel.
Uma expresso de caractere pode incluir referncias a campos ou variveis, ou pode ser
uma cadeia literal. Para usar o comando Encontrar para localizar uma cadeia de caracteres, essa cadeia deve vir entre aspas.
Ao procurar valores que sejam iniciados por espaos em branco, voc deve usar o
comando Encontrar ou a opo Buscar expresso, do comando Pesquisar. Tambm
possvel usar os parmetros Prximo e Enquanto, com Encontrar.
Nota: A funcionalidade do comando Encontrar idntica da opo Buscar expresso,
do comando Pesquisar. O comando Pesquisar acessvel atravs da caixa de dilogo
Pesquisar sendo, conseqentemente, mais prtico de usar. Use Pesquisar em vez de
Encontrar sempre que possvel. Para obter mais informaes, consulte Search (Pesquisar)
na pgina 291.
Pr-requisitos
necessrio que o arquivo de entrada seja indexado por um campo de caractere em
ordem crescente.
298
Manual de Referncia
Sequence (Seqncia)
Use o comando Seqncia para determinar se os campos-chave do arquivo atual esto
em ordem seqencial ou para detectar e relatar falhas, duplicidades ou falta de nmeros
na seqncia.
Voc pode acessar Duplicidades e Falhas como comandos separados do menu Analisar,
ou pode marcar as caixas de seleo nas caixas de dilogo Seqncia, Falhas ou Duplicidades.
O comando Seqncia geralmente usado para procurar documentos duplicados ou
ausentes, tais como nmeros de fatura ou de cheque. Seqncia tambm freqentemente usado para determinar se um arquivo foi ordenado apropriadamente.
Seqncia sempre verifica os campos-chave designados, a fim de determinar se esto
em ordem seqencial, e relata os resultados. Voc pode especificar se a seqncia deve
ou no ser testada em ordem crescente ou decrescente. Os erros de seqncia so
relatados somente at um limite de erros especificado.
Os testes de falhas e os testes de duplicidades so includos no comando Seqncia
porque, para que esses testes sejam realizados com preciso, os dados precisam estar
ordenados apropriadamente. Para isso, voc pode marcar a caixa de seleo
Pr-ordenar ou usar o comando Ordenar ou ndice. O comando Seqncia sempre testa
os erros de ordenao de dados.
Nota: H comandos separados para Falhas e Duplicidades mas eles so sinnimos para
Seqncia e suas sintaxes de comando so idnticas. A palavra-chave Presort
(Pr-ordenar) est disponvel para Falhas e Duplicidades, mas no para Seqncia.
Este comando pode ser de execuo automtica. Para obter mais informaes sobre a
preferncia Execuo automtica de comandos, consulte Opes de comando na
pgina 319 do Guia do Usurio do ACL para Windows.
Captulo 4
Comandos
Sequence (Seqncia)
299
Parmetros
Alm dos parmetros descritos a seguir, o comando Sequence (Seqncia) tem os
seguintes parmetros: All (Tudo), Append (Anexar a um arquivo existente), Ascending
(Crescente), Break (Quebra), Descending (Decrescente), File (Arquivo), File Type
(Tipo de arquivo), First (Primeiros), Footer (Rodap), Graph (Grfico), Header
(Cabealho), If (Se), Local (Local), Name (Nome), Next (Prximos), Print (Imprimir),
Screen (Tela), Suppress (Suprimir outros), While (Enquanto). Para obter uma descrio
desses parmetros, consulte Captulo 3: Parmetros de comandos comuns.
Duplicates (Duplicidades)
Indica que voc deseja testar a existncia de duplicidades (ou um nmero maior de
repeties) nos registros do campo-chave. Consulte tambm Duplicates (Duplicidades) na pgina 174.
Gaps (Falhas)
Indica que voc deseja testar a existncia de falhas na seqncia do campo-chave. Falhas
no funciona se mais de um campo-chave for especificado. Consulte tambm Gaps
(Falhas) na pgina 197.
300
Manual de Referncia
Captulo 4
Comandos
Sequence (Seqncia)
301
Exemplo 1
Para verificar a existncia de duplicidades, falhas e erros de seqncia em um campo de
nmero de fatura contido em um arquivo de transaes de vendas, use Seqncia. Um
nmero de fatura registrado duas vezes ou omitido inteiramente pode indicar
problemas nos controles de um sistema de contabilidade. Falhas no controle resultam
em perda de receita.
Selecione o campo de nmero da fatura a partir da caixa de listagem [Seqncia em] e,
em seguida, selecione Duplicidades, Falhas e Listar intervalos de falha.
O ACL exibe o resultado no Log do comando. O resultado final do comando aparece
como segue. No h erros de seqncia de dados indicando que o arquivo de vendas foi
ordenado de maneira apropriada, com base no nmero da fatura. O nmero total de
falhas ou duplicidades 22.
302
Manual de Referncia
Exemplo 2
O mesmo exemplo executado utilizando a opo Listar itens ausentes e um limite de
itens de 6.
Captulo 4
Comandos
Set (Definir)
303
Observe tambm que o primeiro exemplo relatou 22 erros, enquanto o segundo relatou
39. O motivo disso que as faturas 13030 e 13031 esto ambas ausentes. Isso contou
como um intervalo no primeiro exemplo, mas como dois itens no segundo. Consulte
Duplicates (Duplicidades) na pgina 174 e Gaps (Falhas) na pgina 197 para obter
outros exemplos.
Set (Definir)
Utilize o comando Definir para alterar as preferncias do usurio no ACL. Este
comando permite personalizar o ambiente do ACL para atender suas necessidades.
304
Manual de Referncia
Equivalentes de preferncias
Voc pode acessar as opes do comando Set (Definir) utilizando a caixa de dilogo
Editar preferncias do ACL. A tabela a seguir relaciona a opo Set do modo do
comando com a sua preferncia equivalente. Essas preferncias esto descritas em
Preferncias do ACL na pgina 309 do Guia do Usurio do ACL para Windows.
Opo de definio no modo de comandos Preferncia ACL equivalente
SET BEEP 0-255
Opes de interface
Opes de data
Opes de exibio
Opes de data
SET DESIGNATION
Opes de exibio
Opes de impresso
Opes de data
Opes numricas
Opes de data
Opes de interface
Opes de comando
Opes numricas
Captulo 4
Comandos
Set (Definir)
305
Opes numricas
306
Manual de Referncia
Exemplo
Para desativar o Log de comandos, ao repetir 100 vezes uma seqncia de comando:
COUNTER = 0
SET ECHO NONE
DO REPEAT_BATCH WHILE COUNTER < 100
SET ECHO ON
Exemplo
SET FILTER Amount > 1000
TOTAL Amount
STATISTICS Amount
COUNT IF Dept = "13"
equivale a:
TOTAL Amount IF Amount > 1000
STATISTICS Amount IF Amount > 1000
COUNT IF Amount>1000 and Dept="13"
Captulo 4
Comandos
Set (Definir)
307
308
Manual de Referncia
Exemplo
Para abortar o processamento, caso mais que 20 comandos sejam executados para
qualquer registro:
SET LOOP TO 20
Exemplo 1
Para comutar usando o Newlog.log como o arquivo de Log de comando:
SET LOG TO NEWLOG
Exemplo 2
Para retornar, usando o arquivo de Log de comando original:
SET LOG OFF
Captulo 4
Comandos
Size (Tamanho)
309
Exemplo
Para definir a senha 1 como secreta:
SET PASSWORD 1 TO "secreta"
Size (Tamanho)
Use o comando Tamanho para determinar os tamanhos de amostra apropriados para
amostras de registro e por unidade monetria (MUS).
Nota: A teoria de amostragem estatstica complexa. Se voc no estiver familiarizado
com os julgamentos crticos necessrios durante a realizao de uma amostragem
estatstica, recomendamos que consulte um especialista em estatstica antes de usar os
comandos Tamanho, Amostra e Avaliar do ACL.
O comando Tamanho informa:
310
Manual de Referncia
Tamanhos da Amostra
O comando Tamanho gera os tamanhos de amostra por atributo. Ele no se destina a
gerar tamanho da amostra para amostragem por estimativa ou varivel.
O comando Tamanho produz tamanhos de atributo da amostra vlidos estatisticamente
para a maioria das anlises, exceto se:
O ACL gera tamanhos de amostra utilizando a distribuio de Poisson, em vez da distribuio binomial. A vantagem da distribuio de Poisson que:
Captulo 4
Comandos
Size (Tamanho)
311
Parmetros
Alm dos parmetros descritos a seguir, o comando Size (Tamanho) tem os seguintes
parmetros: File (Arquivo), File Type (Tipo de arquivo), Footer (Rodap), Header
(Cabealho), Local (Local), Name (Nome), Screen (Tela). Para obter a descrio desses
parmetros, consulte Captulo 3: Parmetros de comandos comuns.
312
Manual de Referncia
Populao
Especifique a contagem de registros.
Registro
Indica que a amostra uma amostra por registro sem tendncia. A probabilidade de um
item ser selecionado no est relacionada a seu tamanho. Todos os registros tm iguais
probabilidades de seleo.
Limite de erro superior
Especifique a taxa de erros que voc deseja provar que no excedida na populao.
Opo monetrio
Clique em
(Tamanho) ou selecione a Amostragem na barra de menus, para exibir a
caixa de dilogo Tamanho. Como padro, o ACL exibe a opo Monetrio e seus
parmetros correspondentes.
Clique em [Calcular] para exibir os resultados calculados aps digitar os valores dos
parmetros Tamanho. O tamanho da amostra, o intervalo e e a porcentagem mxima de
erros tolerados so exibidos na rea Resultados da caixa de dilogo.
Captulo 4
Comandos
Size (Tamanho)
313
Opo registro
Clique em
(Tamanho) ou selecione Amostragem, na barra de menus, para exibir a
caixa de dilogo Tamanho. Como padro, o ACL exibe a opo Monetrio e seus
parmetros correspondentes. Selecione Registro para exibir a opo de amostra de
registros.
Clique em [Calcular] para exibir os resultados calculados aps digitar os valores dos
parmetros Tamanho. O tamanho da amostra, o intervalo e o nmero tolervel de erros
so exibidos na rea Resultados, da caixa de dilogo.
Exemplo 1
Para determinar o tamanho da amostra necessrio para obter 95% de confiabilidade de
que o total de erros, em uma populao de 40.000, no exceda 5% (2.000 erros), pressupondo-se que no haja erros na populao:
314
Manual de Referncia
necessrio criar uma amostra de 60 itens. Como o nmero de erros permitidos zero,
se for encontrado algum erro, voc no poder formular a sua hiptese com 95% de
confiabilidade. Se voc optar por criar a amostra acima usando um mtodo de seleo
de intervalo, um intervalo de 666,66 ser apropriado.
Exemplo 2
Para determinar o tamanho da amostra necessrio para ter 95% de confiabilidade de
que o total de erros em uma populao de 40.000 no excede 5% (2.000 erros), pressupondo-se que haja 2% de erros na populao (800 erros):
necessrio criar uma amostra de 184 itens. Como h quatro erros permitidos, desde
que haja quatro erros ou menos em uma amostra, sua hiptese ser comprovada com
Captulo 4
Comandos
Size (Tamanho)
315
95% de confiabilidade. Se voc optar por criar a amostra anterior usando um mtodo de
seleo de intervalo, um intervalo de 217,39 ser apropriado.
Nota: O tamanho da amostra neste exemplo significativamente maior que no Exemplo
1. Isto permite a ocorrncia dos erros que voc esperava detectar.
Exemplo 3
Para determinar o tamanho da amostra necessrio para que voc tenha 90% de confiabilidade de que o total de erros em uma populao de $60 milhes no exceda $1
milho, pressupondo-se que no haja erros na populao:
necessrio criar uma amostra de 138 itens. Como no h erros tolerados, se algum
erro for encontrado, sua hiptese no ser comprovada com 90% de confiana. Se voc
optar por criar a amostra acima usando um mtodo de seleo de intervalo, um
intervalo de $432.900,43 ser apropriado.
Exemplo 4
Para determinar o tamanho de amostra necessrio para que voc tenha 90% de confiabilidade de que o total de erros em uma populao de $60 milhes no exceda $1
milho, pressupondo-se que haja $50.000 de erros na populao:
316
Manual de Referncia
necessrio criar uma amostra de 150 itens. Como h $50.000 em erros previstos, um
certo valor de erros na amostra resultante tolerado. Desde que o total de contaminao
no exceda 12,54%, sua hiptese ser comprovada com 90% de confiana. Se voc optar
por criar a amostra acima usando um mtodo de seleo de intervalo, um intervalo de
$398.701,29 ser apropriado.
As seguintes possveis contaminaes e sua avaliao se referem ao Exemplo 4:
Um item de $950 registrado como um item de $1.000 implica em 5% de contaminao (50/1.000), sendo, portanto, aceitvel.
Dado o erro acima e um outro, onde um item de $15.000 foi registrado como
$14.000 (6,66% de contaminao; 1.000/15.000), os resultados ainda so
aceitveis porque o total de contaminaes de somente 11,66%.
Dados os dois erros acima e um outro onde um item de $100 foi registrado como
$98 (2% de contaminao), a amostra pode ser insuficiente para provar sua
hiptese, j que o total de contaminao de 13,66% (maior que 12,54%). Use o
comando Avaliar para confirmar o efeito dos erros.
Dado um nico erro na populao onde foi registrado um item de $100 por $80
(20% de contaminao), a amostra provavelmente insuficiente para provar sua
hiptese. Como o erro foi encontrado em um item, voc pode pressupor com
segurana que a amostra insuficiente.
Nota: Sempre que houver erros em sua amostra, voc pode usar o comando Avaliar para
determinar o impacto dos erros sobre seus resultados. Voc tambm pode usar o comando
Avaliar para determinar se uma determinada amostra monetria apropriada.
Captulo 4
Comandos
Sort (Ordenar)
317
Sort (Ordenar)
Use o comando Ordenar para ordenar o arquivo de entrada atual em uma seqncia
crescente ou decrescente, com base em campos-chave especificados. O comando
Ordenar cria um novo arquivo que foi fisicamente reorganizado.
O comando Ordenar funciona com arquivos de dados com registro de tamanho fixo e
varivel.
Indexao
Velocidade de execuo
Mais lenta
Mais rpida
Maior
Menor
Mais
Menos
Processamento subseqente de um
arquivo inteiro
318
Manual de Referncia
Captulo 4
Comandos
Sort (Ordenar)
319
Parmetros
Alm dos parmetros descritos a seguir, o comando Sort (Ordenar) tem os seguintes
parmetros: All (Tudo), Append (Anexar a um arquivo existente), Ascending
(Crescente), Descending (Descendente), First (Primeiros), If (Se), Local (Local), Next
(Prximo), To (Para), Use Output File (Usar arquivo de sada), While (Enquanto). Para
obter uma descrio desses parmetros, consulte Captulo 3: Parmetros de comandos
comuns.
320
Manual de Referncia
Exemplo
Neste exemplo voc ordena um arquivo de estoque por um campo-chave. Voc comea
com um arquivo de estoque no ordenado.
Captulo 4
Comandos
Sort (Ordenar)
321
322
Manual de Referncia
Statistics (Estatsticas)
Use o comando Estatsticas para calcular estatsticas descritivas com base em campos
numricos do arquivo de entrada atual.
O comando Estatsticas freqentemente usado para oferecer uma viso geral de um
arquivo de entrada, antes do processamento detalhado. Ele pode rapidamente destacar
anomalias no arquivo de entrada, as quais podem ento estabelecer uma direo para a
sua abordagem ou anlise subseqente.
Estatsticas fornece as seguintes informaes para os campos numricos:
Valor absoluto
Parmetros
Alm dos parmetros descritos a seguir, o comando Statistics (Estatsticas) contm os
seguintes parmetros: All (Tudo), File (Arquivo), File Type (Tipo de arquivo), First
(Primeiros), Footer (Rodap), Graph (Grfico), Header (Cabealho), If (Se), Local
(Local), Name (Nome), Next (Prximo), Print (Imprimir), Screen (Tela), While
Captulo 4
Comandos
Statistics (Estatsticas)
323
Exemplo
Este exemplo mostra como obter estatsticas de vrios campos, utilizando [Se] para
especificar uma condio e exibir as variveis criadas automaticamente pelo comando.
324
Manual de Referncia
O comando Estatsticas permite criar uma viso geral do estoque no Local 3, um dos
diversos locais de estoque da empresa. Os auditores podem querer estatsticas da
quantidade disponvel, do valor de estoque e do valor de mercado, antes de realizarem
uma contagem fsica no local. A gerncia pode querer pesquisar a existncia de itens
incomuns, tais como quantidades disponveis negativas, que possam indicar um
problema no controle do sistema.
Selecione os campos referentes quantidade disponvel, valor de estoque e valor de
mercado na lista de exibio. Na caixa de texto [Se] especifique que deseja estatsticas
somente para o Local 3.
Captulo 4
Comandos
Statistics (Estatsticas)
325
326
Manual de Referncia
Para obter mais detalhes, consulte Variveis na pgina 343 do Guia do Usurio do
ACL para Windows.
Stratify (Estratificar)
Use o comando Estratificar para contar o nmero de registros que recaem sobre intervalos especificados (camadas) de valores de expresses ou campos numricos, bem
como para acumular um ou mais campos para cada camada. A contagem dos registros
de cada camada relacionada na coluna COUNT, no Log do comando.
O comando Estratificar trabalha com arquivos no ordenados e particularmente til
para uma rpida varredura e sumarizao. Estratificar permite que voc conte o nmero
de registros que recaem sobre determinado nmero de intervalos uniformes, fornecendo totais por camada para os campos numricos selecionados. Alternativamente,
voc pode especificar os pontos de incio dos intervalos, utilizando a opo Livre para
criar intervalos personalizados de qualquer tamanho.
Este comando pode ser de execuo automtica. Para obter mais informaes, consulte
Execuo automtica de comandos na pgina 319 do Guia do Usurio do
ACL para Windows.
Captulo 4
Comandos
Stratify (Estratificar)
327
Parmetros
Alm dos parmetros descritos a seguir, o comando Stratify (Estratificar) tem os
seguintes parmetros: All (Tudo), Append (Anexar a um arquivo existente), Break
(Quebra), File (Arquivo), File Type (Tipo de arquivo), First (Primeiros), Footer
(Rodap), Graph (Grfico), Header (Cabealho), If (Se), Local (Local), Name (Nome),
Next (Prximo), Print (Imprimir), Screen (Tela), Suppress (Suprimir outros), Use
Output File (Usar arquivo de sada), While (Enquanto). Para obter a descrio desses
parmetros, consulte Captulo 3: Parmetros de comandos comuns.
Free (Livre)
Permite que voc especifique o ponto inicial de cada intervalo e o ponto final do ltimo
intervalo. Digite esses valores na caixa de texto Livre, um por linha.
Intervals (Intervalos)
Especifica o nmero de intervalos uniformes produzidos pelo ACL ao longo do
intervalo (de Mnimo a Mximo). O padro 10, mas voc pode alter-lo na caixa de
dilogo Editar preferncias do ACL. Consulte Intervalos na pgina 321 do
Guia do Usurio do ACL para Windows.
Maximum (Mximo)
Especifica o valor mximo do ltimo intervalo de estratificao. Se voc emitiu o
comando Perfil ou Estatsticas anteriormente, o valor mais alto no campo aparecer por
padro. Se voc especificou intervalos livres, o valor mais alto especificado ser exibido
como padro.
Minimum (Mnimo)
Especifica o valor mnimo do primeiro intervalo de estratificao. Se voc emitiu o
comando Perfil ou Estatsticas anteriormente, o valor mais baixo no campo estratificado
aparecer como padro.
328
Manual de Referncia
Exemplo 1
Neste exemplo, voc ir produzir estratificaes de intervalos uniformes.
Uma anlise estratificada de um arquivo de contas a receber mostra se ele contm alguns
itens de valor maiores ou vrios menores. Essa informao pode ajudar o gerenciamento a desenvolver os procedimentos de cobrana apropriados.
Antes de utilizar Estratificar nesse tipo de arquivo, til primeiro usar dois comandos
do ACL:
1. Sumarizar. Um arquivo de contas a receber contm vrias transaes individuais,
mas voc quer os saldos das contas. Voc pode obter os saldos das contas dos clientes
utilizando o comando Sumarizar. Sumarize o arquivo pelo campo nmero do cliente
Captulo 4
Comandos
Stratify (Estratificar)
329
O ACL exibe o resultado no Log de comando. Embora 46,89% dos clientes tenham
dbitos de menos de 983,10 cada, esta camada representa 42,90% do total do saldo
de contas a receber.
330
Manual de Referncia
Exemplo 2
Neste exemplo, voc produz estratificaes de intervalo livre.
A estratificao do intervalo livre permite obter mais uma diviso da camada do
Exemplo 1, contendo 46,89% dos clientes.
Selecione [Livre] e, em seguida, especifique 0, 100, 250, 500 e 750 como seus pontos
iniciais de intervalo e 1000 como o ponto final.
Captulo 4
Comandos
Stratify (Estratificar)
331
O Log de comando mostra que a maioria dos saldos de 69,89 a 983,10 esto no intervalo
de 500 a 750.
Sada do comando
A sada no Log de comando tem colunas para os intervalo de camadas, o nmero dos
registros em cada intervalo e o percentual do total de registros que cada intervalo representa. Se um ou mais campos forem acumulados, sero exibidas colunas adicionais:
outra coluna percentual e os totais acumulados dos campos para cada intervalo.
Cada coluna percentual aponta para a coluna que ela representa. A coluna percentual
direita aponta para a coluna do campo acumulado mais prximo e mostra o percentual
do valor total representado por esse intervalo. Os percentuais no so fornecidos para
colunas de campos acumulados adicionais.
Voc pode enviar a sada do comando para um grfico. Clique na guia [Sada] e
selecione a opo Grfico, na caixa de dilogo ou clique duas vezes na sada do comando
ou na instruo <<<Dados do grfico>>> no Log de comando. Para obter mais
informaes, consulte Sada para grfico na pgina 263 do Guia do Usurio do
ACL para Windows.
Voc pode gravar a sada do comando em um arquivo. Clique na guia [Sada] e selecione
a opo Arquivo e, em seguida, selecione o Tipo de arquivo da lista suspensa.
332
Manual de Referncia
Summarize (Sumarizar)
Use o comando Sumarizar para gerar totais de contagem de registros e de valor de
campos numricos, para cada valor distinto dos campos-chave de caractere em um
arquivo ordenado.
O comando Sumarizar permite que voc acumule totais de campos numricos para
cada valor distinto dos campos-chave tipo caractere. O nmero de registros pertencentes a cada valor distinto exibido em um campo gerado pelo ACL, denominado
COUNT. O nmero de valores de campos de caractere distintos que podem ser sumarizados quase ilimitado.
Devido ao fato de poder fornecer relatrios sobre um nmero ilimitado de valores
nicos de campos-chave tipo caractere, o comando Sumarizar mais eficiente para
arquivos com muitas entradas. O comando Sumarizar exige um arquivo ordenado pelos
campos-chave de caractere, por isso, voc deve antes ordenar o arquivo ou marcar a
caixa de seleo Pr-ordenar. No caso de arquivos no ordenados de tamanho pequeno
ou mdio, Classificar um comando eficiente para sumarizar os dados. Para obter mais
informaes, consulte Classify (Classificar) na pgina 136.
O comando Sumarizar permite que voc selecione Outros campos ..., campos de
caractere ou campos numricos a serem includos em sua sada. O primeiro dos
Outros valores de campo encontrado no arquivo de entrada ordenado pertencente a
um determinado grupo sumarizado gravado no arquivo resumido como sendo um
Captulo 4
Comandos
Summarize (Sumarizar)
333
dos Outros valores de campo para aquele grupo. Voc pode desejar incluir um
Outro campo no arquivo sumarizado, se o valor desse campo for constante ao longo
de todo o grupo sumarizado. Por exemplo, se voc criou a sumarizao com base no
nmero do cliente (um campo de caractere), talvez queira especificar o nome do cliente
como sendo o Outro campo, j que o relacionamento entre o nmero do cliente e o
nome do cliente de um para um. Voc pode criar um novo arquivo de entrada com o
comando Sumarizar e usar o arquivo para posterior anlise e gerao de relatrios com
o ACL.
Nota: Voc pode utilizar o comando Sumarizar para remover registros duplicados de um
arquivo. Para fazer isso, especifique o campo de caractere a sumarizar, no acumule
nenhum campo, selecione Outros campos e, em seguida, selecione Adicionar Tudo e envie
a sada para um arquivo. O arquivo de sada conter somente registros nicos.
Pr-requisitos
Este comando requer que todos os arquivos sejam pr-ordenados com base nos
campos-chave tipo caractere, na seqncia de sumarizao pretendida. Se o arquivo no
estiver ordenado, voc pode orden-lo ou index-lo, ou marcar a caixa de seleo
Pr-ordenar.
Nota: Certifique-se de que a caixa de seleo Pr-ordenar esteja desativada ao utilizar um
arquivo de ndice.
Parmetros
Alm dos parmetros descritos a seguir, o comando Summarize (Sumarizar) tem os
seguintes parmetros: All (Tudo), Append (Anexar a um arquivo existente), File
(Arquivo), File Type (Tipo de arquivo), First (Primeiros), Footer (Rodap), Graph
(Grfico), Header (Cabealho), If (Se), Local (Local), Name (Nome), Next (Prximo),
Print (Imprimir), Screen (Tela), Use Output File (Usar arquivo de sada), While
(Enquanto). Para obter uma descrio desses parmetros, consulte Captulo 3:
Parmetros de comandos comuns.
334
Manual de Referncia
Captulo 4
Comandos
Summarize (Sumarizar)
335
Exemplo
Voc sumarizar sobre dois campos neste exemplo. Para sumarizar o estoque por local
e, em cada local, por classe de produto, use Sumarizar. Os Auditores podem fazer essa
sumarizao para direcionar seus procedimentos de teste, e a gerncia para melhor
controlar o estoque.
Na caixa de listagem [Sumarizar em], selecione primeiro o campo referente ao local,
depois o campo referente classe de produto. Acumule os campos quantidade disponvel, valor registrado e valor de mercado na caixa de listagem [Acumular campos]. Se o
arquivo de entrada no estiver ordenado, marque a caixa de seleo Pr-ordenar.
Clique na guia [Sada] e envie a sada para um arquivo denominado
Summarize_sort_location.
336
Manual de Referncia
Tape (Fita)
Utilize o comando Fita para buscar um arquivo especfico em uma fita, contendo dados
de um mainframe ou minicomputador. Voc tambm pode utilizar o comando para
rebobinar uma fita.
Este comando s pode ser executado no modo de comando.
Os arquivos em fita so organizados consecutivamente e cada arquivo separado por
um espao vazio conhecido como marcador de arquivo (file mark). Dois marcadores de
arquivo consecutivos indicam o final dos dados na fita.
Quando uma fita rebobinada, o ACL automaticamente posiciona a unidade no
primeiro arquivo da fita. Mas com o comando Fita voc pode ir para outro arquivo ou
voltar para trs rebobinando a fita. O modo como voc se move para outro arquivo
depende se a sua fita est com ou sem rtulo (label).
Captulo 4
Comandos
Tape (Fita)
337
Voc deve calcular o nmero de marcas de arquivo a saltar. A frmula a ser utilizada
varia, se a fita tiver ou no um rtulo.
A fita sem rtulo contm blocos seqenciais de dados.
Marcador de
arquivo
Dados 1
Bloco de
dados
Dados 2
Dados 3
Dados 4
Dados 5
A fita com rtulo contm um bloco adicional de dados, denominado rtulo, antes e
depois de cada bloco de dados.
Marcador Bloco de
de arquivo dados
Rtulo
Rtulos
Dados 1
Rtulo
Rtulo
Dados 2
Rtulo
Rtulo
Parmetros
O comando Tape (Fita) tem o seguinte parmetro: Skip (Saltar).
Skip (Saltar)
Especifica que a fita avana/retrocede para um arquivo ou bloco de dados especfico.
O ACL salta dois marcadores de arquivo, levando voc ao terceiro bloco de dados.
338
Manual de Referncia
O ACL salta quatro marcadoress de arquivo, levando voc ao quinto bloco de dados,
Dados 2.
Top (Acima)
Use o comando Acima para mover-se para o primeiro registro do arquivo de entrada
atual.
Este comando s pode ser executado no modo de comando. Para obter mais informaes, consulte Emitir comandos na pgina 267 do Guia do Usurio do
ACL para Windows.
Este comando til aps um parmetro de escopo Next (Prximo) ou While
(Enquanto) ter posicionado o arquivo em um registro diferente, ou aps um registro
especfico ter sido localizado com o comando Search (Pesquisar).
Total
Captulo 4
Comandos
Verify (Verificar)
341
Verify ( Verificar)
Use o comando Verificar para verificar a existncia de erros de validade dos dados no
arquivo de entrada atual.
O comando Verificar , geralmente, um dos primeiros comandos usados quando se est
lidando com um novo arquivo de entrada. Verificar assegura que os dados de um
arquivo esto em conformidade com as definies de arquivo de entrada e relata
quaisquer erros encontrados.
O comando Verificar usa a descrio da definio de arquivo de entrada para verificar os
campos especificados, em busca de erros de validade de dados. Todos os campos
definidos so analisados para garantir que os dados estejam consistentes com o tipo de
340
Manual de Referncia
Exemplo 1
Este exemplo totaliza um campo de valor, a fim de determinar o valor total de estoque
para reconciliao com registros de contabilidade. Selecione o campo Value (Valor)
registrado a partir da caixa de listagem Totalizar campos.
Exemplo 2
Este exemplo totaliza os registros que atendem a uma condio especificada.
Para totalizar um campo de valor de mercado e um campo de valor de estoque para uma
determinada classe de produto, use Total. Em geral, uma classe de produto sofre uma
queda no valor de mercado devido a mudanas econmicas ou tecnolgicas. Para
assegurar-se de que o valor registrado sempre menor ou igual ao valor de mercado,
voc talvez queira comparar esses dois totais para uma classe de produto.
Selecione os campos referentes ao valor de mercado e ao valor de estoque a partir da
caixa de listagem. Na caixa de texto [Se], fornea uma expresso que limite sua anlise
classe de produto 8:
Captulo 4
Comandos
Verify (Verificar)
341
Verify ( Verificar)
Use o comando Verificar para verificar a existncia de erros de validade dos dados no
arquivo de entrada atual.
O comando Verificar , geralmente, um dos primeiros comandos usados quando se est
lidando com um novo arquivo de entrada. Verificar assegura que os dados de um
arquivo esto em conformidade com as definies de arquivo de entrada e relata
quaisquer erros encontrados.
O comando Verificar usa a descrio da definio de arquivo de entrada para verificar os
campos especificados, em busca de erros de validade de dados. Todos os campos
definidos so analisados para garantir que os dados estejam consistentes com o tipo de
342
Manual de Referncia
Parmetros
Alm dos parmetros descritos a seguir, o comando Verify (Verificar) tem os seguintes
parmetros: All (Tudo), Append (Anexar a um arquivo existente), File (Arquivo), File
Type (Tipo de arquivo), First (Primeiros), Footer (Rodap), Graph (Grfico), Header
(Cabealho), If (Se), Local (Local), Name (Nome), Next (Prximo), Print (Imprimir),
Screen (Tela), While (Enquanto). Para obter a descrio desses parmetros, consulte
Captulo 3: Parmetros de comandos comuns.
Captulo 4
Comandos
Verify (Verificar)
343
Exemplo
Este exemplo verifica todos os campos de um arquivo.
Para verificar a validade dos dados, com referncia definio de arquivo de entrada,
use Verificar. Se voc no tiver certeza sobre a integridade dos dados, poder executar o
comando Verificar antes de processar, de forma detalhada, qualquer arquivo de entrada.
Selecione todos os campos da caixa de listagem e aceite o Limite de erro padro definido
em 10.
344
Manual de Referncia
O ACL exibe a localizao dos dados invlidos e, em baixo, sua representao hexadecimal.
Voc pode usar o comando Descarregar para analisar o contedo de cada registro
invlido. Consulte Dump (Descarregar) na pgina 170 para obter mais detalhes.
Captulo 4
Comandos
Verify (Verificar)
345
346
Manual de Referncia
Apndice A
O ACL para Windows permite que voc utilize os arquivos de formato, batches e
relatrios do ACL for OS/390. Entretanto, preciso primeiro converter os arquivos em
uma das duas maneiras a seguir:
347
348
Manual de Referncia
4. Na caixa de texto Nome do arquivo, digite um nome para o Projeto em que o ACL
incluir os arquivos convertidos e clique em [Salvar].
O ACL exibe a janela de converso e verifica o diretrio quanto a arquivos de
formato, relatrio e batch.
Quando a verificao estiver completa, o ACL exibe a caixa de dilogo Converter
com todos os itens pr-selecionados. Para aceitar todos os itens, clique em [OK].
Se deseja selecionar somente alguns dos itens exibidos na caixa de dilogo
Converter, utilize o boto Importar do OS/390 na janela Viso Geral.
Apndice A
349
Batches a serem
convertidos
Mensagens de converso
A janela Status da converso pode exibir um dos seguintes tipos de mensagens durante
a converso:
Mensagens informativas
Processando batches
Indica que o utilitrio est processando atualmente todos os arquivos de batch (*.bat)
que encontra no diretrio selecionado.
350
Manual de Referncia
Processando formatos
Indica que o utilitrio est processando arquivos de formato (*.fmt). O utilitrio vincula
os arquivos que foram usados nos batches. Se um formato no foi usado em um batch,
o utilitrio considera um arquivo de dados do mesmo nome, mas com extenso FIL.
Formato do relatrio
Relaciona os arquivos de relatrio e formatos utilizados.
Mensagens de erro
<nomedoarquivo> truncado em <n> caracteres
Indica que, ao processar arquivos de batch, um comando Open foi encontrado com um
nome de arquivo que excedia o comprimento mximo permitido de oito caracteres.
Apndice A
351
352
Manual de Referncia
Batches
Arquivos de batch convertidos aparecem na lista de batches da janela Viso geral.
Nota: necesssrio examinar e executar os batches antes de us-los para produo. Pode
no ser possvel executar os batches convertidos no ACL para Windows por diversos
motivos. Procure mensagens indicando comandos que no so permitidos.
Por exemplo, o comando Extrair no requer mais uma condio. Se tiver um batch que
inclua o comando Extrair, voc pode precisar edit-lo antes que seja executado.
Arquivos de formato
Arquivos de formato convertidos tornam-se definies de arquivo de entrada e so
armazenados como parte do Projeto. O ACL no armazena arquivos de dados como
parte do Projeto. Em vez disso, quando voc abre uma definio de arquivo de entrada,
o ACL automaticamente vincula-o ao arquivo de dados apropriado.
Apndice A
353
Relatrios
Os relatrios so baseados em exibies, por isso os relatrios convertidos aparecem no
novo Projeto como exibies.
O ACL exibe todos os relatrios convertidos (exibies) na janela Viso Geral sob
Exibies. Os relatrios citados em um batch possuem o nome do arquivo de entrada
correspondente exibido entre colchetes aps o nome do relatrio. Todos os outros
relatrios convertidos possuem a palavra desconhecido entre colchetes, porque o ACL
no pode vincul-los a um arquivo de dados especfico.
1. Para acessar os relatrios que possuem uma definio de arquivo de entrada desconhecida, faa o seguinte:
354
Manual de Referncia
Apndice B
Uma viso geral dos componentes que formam um sistema de unidade de fita
Instrues passo-a- passo que voc pode seguir para ler os dados da fita
Nota: Se voc usou o ACL for OS/390 para acessar dados em fita, talvez j esteja familiarizado com muitas das operaes descritas neste captulo.
356
Manual de Referncia
unidade de fita
driver de dispositivo
placa controladora
cabos de conexo
Unidade de fita
O ACL pode ler dados diretamente de quase todos os formatos de fita, inclusive:
fitas de 8 mm
fitas DAT de 4 mm
Se for necessrio ler dados de fitas de de polegada, entre em contato com o Suporte
Tcnico da ACL para obter assistncia.
O seu drive de fita deve trabalhar com SCSI (pronuncia-se scuzzy), um padro de
interface paralela, para ser compatvel com o ACL.
A velocidade de acesso aos dados de uma fita depende da velocidade da sua unidade de
fita.
Nota: possvel conectar mais de uma unidade de fita ao seu computador. Neste caso,
certifique-se de ligar apenas a unidade a partir da qual voc pretende ler os dados. Ao
conectar e executar vrias unidades de fita, o ACL acessa apenas a primeira unidade
designada na cadeia SCSI.
Driver do dispositivo
O driver de dispositivo funciona como um tradutor entre o ACL e a placa controladora.
A placa controladora no consegue compreender os comandos do ACL sem a interveno do driver de dispositivo. O ACL para Windows Verso 7 requer um driver
WINASPI.
Apndice B
357
Placa controladora
A placa controladora do seu computador funciona como uma ligao entre o computador e a unidade de fita. A placa, junto com o driver de dispositivo, controla o fluxo de
dados da unidade de fita.
possvel utilizar qualquer placa SCSI que tenha drivers compatveis com ASPI.
Utilitrios de fita
As placas controladoras geralmente incluem utilitrios que ajudam a realizar funes de
fita padro, como:
Posicionamento da fita
Transferncia de dados em disco para uma fita e dados em fita para disco
Cabo de conexo
O cabo conecta a unidade de fita ao computador. Para usar o ACL com uma fita, necessrio usar um cabo compatvel com SCSI.
Antes de iniciar
Antes de comear a ler os dados armazenados na fita, certifique-se de ter:
Quando tiver todas as informaes sobre a fita e o arquivo com o qual deseja trabalhar,
e a fita estiver na unidade, voc est pronto para comear.
358
Manual de Referncia
Fita no-rotulada
Uma fita no-rotulada organizada em arquivos de dados consecutivos separados por
marcas de arquivo. Os retngulos escuros representam marcas de arquivo.
Marcador de
arquivo
Dados 1
Bloco de
dados
Dados 2
Dados 3
Dados 4
Dados 5
Fita rotulada
Uma fita rotulada contm um bloco de dados extra (denominado rtulo) antes e
depois de cada arquivo. O rtulo fornece informaes sobre o arquivo de dados e como
o arquivo foi gravado.
Marcador Bloco de
de arquivo dados
Rtulo
Dados 1
Rtulos
Rtulo
Rtulo
Dados 2
Rtulo
Rtulo
Se quiser acessar um arquivo que no seja o primeiro em uma fita rotulada, use a
frmula 3(d-1)+1 para calcular o nmero de blocos de dados a serem saltados, onde n
o nmero do arquivo que voc deseja acessar. Por exemplo, se voc deseja acessar o
quinto arquivo em uma fita rotulada, digite TAPE SKIP 13 no Log de comando.
Apndice B
359
Posicionar a fita
Antes de acessar um arquivo na fita, preciso posicionar a fita no incio do arquivo.
Uma fita rebobinada j est corretamente posicionada para ler o primeiro arquivo, j
que o ACL acessa automaticamente o primeiro arquivo nas fitas rotuladas ou
no-rotuladas.
Se quiser acessar um arquivo que no seja o primeiro da fita, preciso saber se est
trabalhando com uma fita rotulada ou no-rotulada, e usar o comando tape do ACL
para posicionar a fita corretamente:
1. Na barra de comandos, selecione Janela e escolha Abrir Log de comando.
O ACL exibe o Log de comando.
2. Emita o comando Tape de uma das seguintes formas:
Rebobinar a fita
Se voc no tiver certeza de que a fita est posicionada no incio do arquivo que deseja
acessar, especifique um valor negativo como TAPE SKIP -10 na caixa de texto do Log
de comando.
Especificar um nmero negativo grande (tal como -10) faz com que o ACL rebobine
completamente a fita. O sinal de menos informa ao ACL para voltar a fita. Se voc estiver
trabalhando com uma fita que contm um nmero muito grande de arquivos, talvez seja
preciso rebobinar mais de 10 marcas de arquivo.
360
Manual de Referncia
preciso cancelar o comando Set Accelerate para retornar velocidade de rebobinamento normal. Para cancelar Set Accelerate, digite:
SET ACCELERATE 100
Apndice B
361
362
Manual de Referncia
Se voc observou esses procedimentos de soluo de problemas, mas ainda est tendo
problemas para ler a fita com o ACL, entre em contato com o Suporte Tcnico da ACL.
Apndice C
G LOSSRIO
Esta seo contm uma lista em ordem alfabtica de termos do ACL e seus significados.
Mais informaes sobre cada termo, junto com exemplos prticos de seu uso no ACL,
esto includas nas sees apropriadas do Guia do Usurio.
Amostragem de unidade monetria
Abrevia-se como unidade monetria (MUS). Em amostragem, um mtodo de seleo
de registros em que a probabilidade de seleo proporcional ao valor de um campo;
quanto maior o valor do campo, maior a possibilidade de esse campo ser selecionado.
Amostragem por registro
Em amostragem, um mtodo de seleo de registros em que cada registro possui a
mesma chance de ser selecionado. A amostragem por registro tambm conhecida
como amostragem por atributo.
Anexar
Um processo de adicionar os registros de sada de um comando ao fim de um arquivo j
existente. Anexar pode ser usado em vez de mesclar em vrias situaes.
Consulte tambm Mesclar na pgina 372.
rea de trabalho
Um arquivo que armazena definies de campo que podem ser aplicadas a diversos
arquivos de dados. Geralmente, trata-se de campos calculados que se referem ao
ambiente atual, mas tambm podem ser descries e nomes de campo exclusivos. O uso
de um arquivo de rea de trabalho permite que voc estenda o seu arquivo de entrada
atual sem ter que definir campos extra.
rea de trabalho do aplicativo
O local em que voc executa o seu trabalho no ACL. a rea em que as janelas e as caixas
de dilogo do ACL so exibidas.
Argumento
Um valor de campo ou expresso de qualquer tipo, usado em um teste.
Aritmtica de ponto fixo
Um mtodo de processamento usado pelo ACL para todas as operaes numricas (em
oposio aritmtica de ponto flutuante). A aritmtica de ponto fixo aprimora a
velocidade de processamento e permite que o usurio tenha controle sobre nmeros
decimais e arredondamento.
363
364
Manual de Referncia
Arquivo CR
Um arquivo em que o fim de um registro indicado por um retorno de carro (CR). Esta
a forma padro de separar arquivos de linha em computadores compatveis com
Macintosh.
Arquivo CR/LF
Um arquivo de comprimento de registro varivel em que o fim de um registro indicado
por um caractere de retorno de carro (CR) e de alimentao de linha (LF).
Arquivo de dados
Um arquivo em que so armazenados dados existentes em um computador. Tambm
chamado de arquivo-fonte. Na verdade, esse arquivo no est armazenado como parte
de um Projeto ACL mas sim vinculado ao Projeto pela definio de arquivo de entrada.
O ACL no altera o arquivo de dados de forma alguma.
Arquivo de entrada
Um termo que se refere ao arquivo de dados juntamente com a definio de arquivo de
entrada.
Consulte tambm Arquivo de dados na pgina 364 e Definio de arquivo de
entrada na pgina 368.
Arquivo de log
Um registro cumulativo de todos os comandos emitidos do ACL, seguidos por seus
resultados, durante as sesses anteriores do ACL at o momento em que o Log foi limpo
pela ltima vez.
O ACL cria automaticamente um arquivo de log especfico para o Projeto criado, e grava
a data e a hora de cada comando.
Arquivo de relatrio
Um arquivo que geralmente uma duplicata exata de um relatrio impresso em formato
eletrnico. Algumas vezes tambm chamado de arquivo de spool de impresso.
Arquivo de vrias bobinas
Um arquivo de dados que se expande por mais de uma bobina ou cartucho de fita
magntica, ou que se expande por alguns data sets em uma bobina ou cartucho que
possua o mesmo formato de campo.
Arquivo de vrios tipos de registros
Um arquivo de dados que contm mais de um tipo de registro. Por exemplo, um arquivo
de relatrio que possui cabealho, registros de detalhe e de finalizao. O comprimento
do registro pode ser fixo ou varivel.
Apndice C
Glossrio
365
Arquivo delimitado
Arquivos em que cada campo em um registro separado dos outros por um caractere
separador de campo. Os campos no possuem uma posio fixa.
Existem duas convenes principais para arquivos delimitados: CSVs (Valores
separados por vrgula) e TSVs (Valores separados por tabulao). Em ambos os casos,
um retorno de carro (CR) e um avano de linha (LF) geralmente separam cada registro
no arquivo.
Arquivo legado
Arquivos de dados mais antigos gerados principalmente em computadores mainframe.
Estes tipos de arquivos no possuem definio de dados interna, sendo assim, preciso
criar uma definio de arquivo de entrada para eles.
Consulte tambm Definio de arquivo de entrada na pgina 368.
Arquivo primrio
O arquivo nico em que voc est trabalhando no momento. Voc s pode abrir um
arquivo primrio de cada vez. Um arquivo primrio e um secundrio so usados em
operaes Associar e Mesclar.
Consulte tambm Arquivo de vrias bobinas na pgina 364.
Arquivo secundrio
O segundo arquivo que voc abre quando h dois arquivos abertos ao mesmo tempo.
Voc s pode abrir ou configurar um arquivo secundrio de cada vez. Um arquivo
primrio e um secundrio so usados em operaes Associar e Mesclar. O arquivo
secundrio o segundo arquivo usado em operaes Associar e Mesclar.
Consulte tambm Arquivo primrio na pgina 365.
Arquivo seqencial
Um arquivo de dados (tal como um arquivo de fita) cujos registros devem ser acessados
em uma ordem fixa, um aps o outro.
Arquivo tipo bucketed
No ACL, um arquivo cujos registros contm blocos repetidos de campos de estrutura e
tamanho semelhantes. Cada bloco denominado um bucket.
ASCII
Sigla de American Standard Code for Information Interchange. ASCII o conjunto de
caracteres mais comum usado para facilitar a troca de dados e a comunicao entre
microcomputadores.
Consulte tambm EBCDIC na pgina 369.
366
Manual de Referncia
Associao de arquivos
Um processo que combina os dados de transao com os registros do arquivo de
cadastro, ou compara o contedo dos campos de dois arquivos. O comando Associar do
ACL permite a combinao dos campos de dois arquivos com estruturas diferentes em
um terceiro arquivo e tambm pode identificar registros correspondentes ou
no-correspondentes em um, ou em ambos os arquivos.
AVERAGEn
Uma varivel especial do ACL criada automaticamente por comandos especficos, tal
como o comando Estatsticas, que contm o valor mdio do campo em que o comando
foi emitido pela ltima vez.
Batch
Uma seqncia de comandos do ACL definidos e armazenados em um Projeto. Voc
pode criar um batch a ser executado repetida e automaticamente, ou para solicitar informaes do usurio.
Batch interativo
Um batch que solicita informaes do usurio enquanto est sendo executado.
Consulte tambm Batch na pgina 366.
Buffer
Espao de armazenamento temporrio para dados que esto sendo transmitidos de um
componente de computador para outro. Um buffer compensa as diferenas de
velocidade em que os componentes podem processar os dados que esto sendo roteados
para eles.
Cadeia de caracteres
Uma seqncia de caracteres.
Campo
Unidades individuais de informao que formam um registro em um arquivo. Um
registro pode ter diversos campos. Cada campo possui um nome para referncia.
Consulte tambm Registro na pgina 374.
Campo calculado
Uma expresso algbrica definida que usa os resultados de clculo ou um comando do
ACL para criar dados adicionais.
O campo calculado s existe na definio de arquivo de entrada e no realmente uma
parte do arquivo de dados. Trata-se de um campo virtual que permite a realizao de
Apndice C
Glossrio
367
clculos com base em informaes do arquivo de dados sem afetar ou alterar os dados
originais. possvel tratar um campo calculado como um campo fsico real.
Consulte tambm Campo fsico na pgina 367.
Campo-chave
Um campo de ordenao. Quando se ordena um arquivo, o campo-chave o campo que
voc informa ao ACL para usar na criao da seqncia de ordenao.
Campo condicional
Um campo cujo valor depende de uma condio.
Consulte tambm Campos condicionais calculados na pgina 164 do Guia do Usurio
do ACL para Windows e Campos condicionais estticos na pgina 176 do
Guia do Usurio do ACL para Windows.
Campo fsico
Ao contrrio de um campo virtual ou calculado, um campo fsico se refere a dados que
existem diretamente no arquivo de dados.
Consulte tambm Campo calculado na pgina 366.
Campo ou coluna de quebra
Um campo ou coluna-chave de ordenao que o ACL usa para imprimir automaticamente uma linha de subtotal em um relatrio, sempre que o contedo do campo ou da
coluna for alterado.
Campo sobreposto
A parte de um campo j definido que redefinida como um campo diferente.
Campo virtual
Consulte Campo calculado na pgina 366.
Campos/expresses ad hoc
Uma expresso ou campo no-definido usado para clculos temporrios que no
salvo como parte de uma definio de arquivo de entrada.
Consulte tambm Expresso na pgina 370.
Caractere
Uma letra, dgito ou outro smbolo utilizado para representar dados. Os dados tipo
caractere so normalmente utilizados para representar seqncias de texto ou informaes sobre data.
368
Manual de Referncia
Condio
Um teste que retorna um valor verdadeiro ou falso.
Constantes
Qualquer valor de data, numrico, de cadeia ou lgico que no se altera quando o ACL
processa um registro.
Contaminao
Em amostragem, o valor do erro referente a um item especfico.
COUNTn
Uma varivel especial do ACL criada automaticamente por comandos especficos, tal
como o comando Estatsticas. COUNTn contm o nmero de registros do arquivo, em
que esse comando foi emitido pela ltima vez.
Dados imprprios
Dados que so tecnicamente vlidos, mas no corretos. Por exemplo, valores negativos
em um campo numrico que deve conter apenas valores positivos.
Dados incompletos
Dados que contm falhas ou que no esto na seqncia correta.
Dados inconsistentes
Dados aos quais no existem dados correspondentes ou comparveis em outro campo
ou arquivo.
Dados invlidos
Os dados em um campo que no correspondem ao tipo de campo atribudo a esse
campo.
Definio de campo
Uma definio de campo identifica e descreve o formato dos dados em um arquivo. Os
arquivos eletrnicos podem conter muitos campos para o mesmo registro. Geralmente,
cada registro em um arquivo contm os mesmos campos.
Definio de arquivo de entrada
Descreve a estrutura, o contedo e o layout de um arquivo de dados e vincula o arquivo
de dados ao Projeto. Inclui informaes como nomes de campo, definies de campo e
tipos de campo. O ACL fornece automaticamente a voc algumas dessas informaes,
tais como tipo de arquivo, tipo de caractere, tipo de mdia, nmero de registros e
comprimento de registro. Uma definio de arquivo de entrada s definida e criada
uma vez para um determinado arquivo de dados.
Apndice C
Glossrio
369
EBCDIC
Uma sigla de Extended Binary Coded Decimal Interchange Code. Um conjunto de
caracteres usado principalmente por minicomputadores e mainframes da IBM em
oposio ao conjunto de caracteres ASCII usado pela maioria dos microcomputadores.
Consulte tambm ASCII na pgina 365.
Else
Um comando do ACL que voc pode usar em comandos Grupo para fornecer um
mtodo alternativo de processamento se todos os testes anteriores forem falsos. Else s
pode ser usado em um Grupo, nunca sozinho.
End
Um comando do ACL que fecha ou finaliza comandos Grupo. End s pode ser usado em
um Grupo, nunca sozinho.
Enquanto
Um parmetro de escopo que termina o processamento de um arquivo assim que o teste
associado falha. til na limitao do escopo de comandos que, caso contrrio, processariam o arquivo inteiro.
Consulte tambm Parmetro de escopo na pgina 373.
Espao em branco
A rea em branco em torno do texto. O ACL usa o espao em branco disponvel em um
relatrio para assegurar que os seus dados sero exibidos completamente.
Esttico
Este termo se refere a um registro cujos valores de campo voc no deseja alterar para
todos os registros relacionados. O modificador esttico geralmente usado junto com
arquivos de vrios tipos de registros em que os valores em um registro se relacionam
com os registros subseqentes.
Exibio
A exibio de dados em um arquivo, de acordo com a forma em que voc definiu os
campos do arquivo. Uma exibio do ACL no contm dados. Trata-se apenas de uma
organizao ou apresentao dos dados na tela.
Exibio padro
Uma exibio que mostra campos de dados definidos na ordem em que aparecem no
arquivo de dados.
370
Manual de Referncia
Apndice C
Glossrio
371
Funes
Uma rotina que aceita zero ou mais parmetros realiza um clculo e retorna um valor.
GAPDUPn
Uma varivel especial do ACL criada automaticamente por comandos especficos do
ACL, tais como os comandos Sequence, Gaps ou Duplicates, que contm o nmero de
falhas e/ou duplicidades no arquivo em que o comando foi emitido pela ltima vez.
Grupo
Uma seqncia de comandos que processada como uma unidade em uma passagem
nica por um arquivo. Voc pode criar um grupo em um batch, em seguida, processar o
batch para executar os comandos do grupo. O uso de grupos aumenta a velocidade de
processamento, j que o ACL executa todos os comandos de grupo em uma nica
passagem pelo arquivo, em oposio a uma passagem do arquivo para cada comando.
Grupo aninhado
Um grupo de comandos incorporados em outro grupo de comandos. O aninhamento
de grupos aumenta a fora do grupo permitindo o controle em relao a quais
comandos sero executados para qual registro.
Consulte tambm Grupo na pgina 371.
HIGHn
Uma varivel especial do ACL criada automaticamente por comandos especficos, tal
como Estatsticas, que contm os cinco valores mais altos (como padro) do campo em
que o comando foi emitido pela ltima vez.
Histograma
Um grfico de barras horizontais criado por meio do comando Histograma do ACL. Os
histogramas mostram a distribuio de valores em um campo ou expresso. Um histograma o equivalente grfico da estratificao de dados.
Histrico
Um Log especfico de arquivo que registra os comandos e a origem dos dados que voc
usa. O histrico adicionado definio de arquivo de entrada sempre que o ACL cria
um arquivo de dados como sada. O ACL grava a data e a hora de todos os comandos em
um arquivo de histrico. Vrias preferncias das Opes de impresso permitem a
impresso de um histrico de arquivo e outras informaes ao imprimir um relatrio ou
uma exibio.
Consulte tambm HIGHn na pgina 371.
372
Manual de Referncia
Histrico do arquivo
Um registro do processo usado quando o ACL cria um arquivo de dados como sada. O
histrico do arquivo inclui cada etapa usada na criao do arquivo, junto com um
registro de data e hora. O ACL tambm indica o nmero de registros no arquivo de
sada, o nome do arquivo a partir do qual a sada foi criada e o nmero dos registros
desse arquivo.
Consulte tambm Histrico na pgina 371.
If
Um parmetro de escopo que seleciona apenas alguns registros do arquivo, ou limita a
execuo de comandos do ACL. Por exemplo, COUNT IF AMOUNT > 0.
Consulte tambm Parmetro de escopo na pgina 373.
Tambm um comando que realiza uma ao se uma condio verdadeira, tal como:
IF TOTAL>1000000.
ndice
Um mtodo de seqenciamento de dados. O comando ACL Index tambm cria um
arquivo de ndice. Este arquivo contm ponteiros que permitem ao ACL ler dados na na
seqncia de ordenao, mesmo que os registros do arquivo de entrada original no
estejam ordenados. O processo de criao de um arquivo de ndice chama-se
indexao.
Log de comando
Um Log eletrnico que registra cada comando emitido e seus resultados, a partir do
momento em que voc abre um Projeto ACL at que ele seja fechado. As informaes do
Log so cumulativas. Voc pode visualizar, adicionar comentrios, imprimir ou limpar
o Log.
LOWn
Uma varivel especial do ACL criada automaticamente por comandos especficos, tal
como o comando Estatsticas, que contm os cinco valores mais baixos (como padro)
do campo em que o comando foi emitido pela ltima vez.
MAXn
Uma varivel especial do ACL criada automaticamente por comandos especficos, tal
como o comando Estatsticas, que contm o valor mais alto do campo em que o
comando foi emitido pela ltima vez.
Mesclar
Um processo que combina dois arquivos ordenados com uma estrutura de registro
idntica em um terceiro arquivo. Por exemplo, voc pode mesclar arquivos estruturados
Apndice C
Glossrio
373
>
AND
^
=
&
*
>=
OR
/
<=
|
+
<>
374
Manual de Referncia
batch. Exemplos: If, While, Next e First. Os parmetros de escopo podem ser usados
separadamente ou em conjunto.
Perodo
O nmero de dias entre duas datas especficas. Voc pode calcular o tempo transcorrido
desde uma transao subtraindo uma data de outra.
Primeiros
Um parmetro de escopo que seleciona um nmero especificado de registros,
comeando pelo primeiro registro do arquivo.
Consulte tambm Parmetro de escopo na pgina 373.
Projeto ACL
Um arquivo que contm todas as definies de arquivo do ACL (exibies, relatrios,
reas de trabalho e batches). O arquivo que contm os dados a serem analisados no faz
parte do Projeto, mas vinculado ao mesmo por meio da definio de arquivo de
entrada.
O nome de arquivo do Projeto utiliza a extenso .acl, que tambm atribuda aos
Projetos temporrios.
Consulte tambm Definio de arquivo de entrada na pgina 368.
Prximo
Um parmetro de escopo que faz o comando atual ser aplicado a apenas uma parte
subseqente do arquivo primrio.
Consulte tambm Parmetro de escopo na pgina 373.
RANGEn
Uma varivel especial do ACL criada automaticamente por comandos especficos, tal
como o comando Estatsticas, que contm a diferena entre as variveis MAXn e MINn.
Ela fornece o intervalo entre o valor mais alto e o valor mais baixo.
Registro
Uma unidade de itens de informaes relacionados que compe um arquivo. Cada
registro contm partes individuais de informaes chamadas de campos.
Consulte tambm Campo na pgina 366.
Rgua
A rgua do ACL usada como um guia para a definio de campos, j que marca a
posio de byte de cada campo no arquivo de dados.
Apndice C
Glossrio
375
SAMPINTn
Uma varivel especial do ACL criada automaticamente por comandos especficos, tal
como o comando Tamanho, que contm o intervalo de amostra baseado em dados
fornecidos ao comando.
SAMPSIZEn
Uma varivel especial do ACL criada automaticamente por comandos especficos, tal
como o comando Tamanho, que contm o tamanho da amostra baseado nos dados
fornecidos ao comando.
Tipos de campo
Os tipos de dados que o ACL pode ler. Como os tipos de dados normalmente se aplicam
aos campos dos registros de dados de entrada, eles so comumente chamados de tipos
de campo.
O ACL suporta a maioria dos tipos de campo, incluindo aqueles encontrados em aplicativos especficos, tal como o tipo de campo numrico encontrado no sistema de contabilidade ACCPAC.
Tipos de dados
Consulte Tipos de campo na pgina 375.
UELn
Uma varivel especial do ACL criada automaticamente por comandos especficos, tal
como o comando Avaliar, que contm o limite de erro superior do conjunto de dados
em que o comando foi emitido pela ltima vez.
Variveis
Os valores temporrios que existem na memria, no mximo, durante uma sesso do
ACL. As variveis podem ser usadas para reter e carregar informaes de um comando
do ACL para outro. A nica exceo uma varivel cujo nome se inicia com um sublinhado (_). Essas variveis so armazenadas como parte de seu Projeto.
Alguns comandos criam variveis automaticamente quando so executados. possvel
usar as variveis geradas pelo ACL, ou as variveis que voc cria, ao processar outros
comandos do ACL. Uma varivel preserva seu valor at voc alter-la ou sair do ACL.
Varivel ABSn
Uma varivel especial do ACL criada automaticamente por comandos especficos, tal
como o comando Estatsticas, que contm o valor absoluto do campo em que o
comando foi emitido pela ltima vez.
376
Manual de Referncia
WRITEn
Uma varivel especial ACL criada automaticamente por comandos especficos do ACL,
como Seqncia, Falhas ou Duplicidades, contm erros de seqncia de dados encontrados; at o nmero mximo especificado em suas preferncias.
377
ndice Remissivo
A
A esquerda, zeros, filtrar da
cadeia 55
Abrir 240
Abrir arquivos criados por
comandos 107
Abrir arquivos de fita 242
Abrir, opo Comprimento do
Buffer 240
Abrir, palavra-chave
Relacionamentos 241, 268
Abrir, parmetro 107
Abrir, parmetro. Consulte tambm
Usar Arquivo de Sada
Accept 115
Aceitar 115
Acima 338
Activate 120
Acumular campos
Estratificar, comando 327
Perodo, comando 123
Resumir, comando 333
Age 123
Ajuda 203
Ajustar posio inicial do campo
utilizando OFFSET( ) 65
Aleatrio 249
Aleatrio, exibio de colunas 249
Aleatrio, intervalo 250
Aleatrio, intervalo, especificar 250
Aleatrio, Opes da caixa de
dilogo Amostra 285
Aleatrio, ordem de
classificao 250
Aleatrio, ponto de partida 250
Aleatrio, ponto de partida,
especificar 250
Aleatrio, somente nmeros
exclusivos 250
Aleatrios, nmeros, gerar 70, 249
Alinhar campos usando o comando
Deslocar Campos 191
All 91
Alterar variveis de cabealho 128
Amostra 278
reas de trabalho
ativar 120
definidas 290
excluir no modo de
comando 150
salvar 290
Aritmtica de ponto fixo, no
comando Calcular 134
Arquivo filho, selecionar na caixa de
dilogo Relacionamentos 261
Arquivos
abertos 166
abrindo no modo comando 240
abrir, mtodo arrastar e
soltar 261
fechar no modo comando 248
fita, definindo 361
histrico, exibir 194
indexados. Consulte o comando
Pesquisar
mesclar 234
nomear 104
ODBC, importar 210
OS/390 convertidos 351
pesquisa por tamanho 45
reduzir tamanho do arquivo antes
da classificao 186
relacionados, critrios para
escolha 256
relacionar, procedimento 261
renomear no modo de
comando 269
servidor, salvar na unidade
local 104
tamanho, localizar 45
Arquivos batch, convertidos do
OS/390 352
Arquivos de comprimento varivel
abrir no modo de comando 241
Arquivos de relatrio
convertidos do OS/390 353
Arquivos de servidores, restries
de associao 221
Arredondar para o prximo nmero
inteiro 77
378
ndice Remissivo
As 92
Ascendente, ordenao 319
Ascending 93
ASCII 8
ASCII, arquivos de comprimento
varivel, abrir no modo de
comando 241
ASCII, caracteres de byte 35
ASCII, convertendo em
EBCDIC 42
ASCII, exibir usando comando
Descarregar 172
ASCII, formatar, comando
Listar 229
ASCII, valor decimal
equivalente 36
ASCII, valor decimal, localizar 29
Aspas
Comando Localizar,
utilizao 196
invertidas, em expresses de
data 11
Associao
arquivos no modo de
comando 227
Associar 218
Associar arquivos,
procedimento 224
Associar nomear arquivos 221
Associar registros correspondentes,
todas opes secundrias 220
Associar registros correspondentes,
todos s opes primrias e
secundrias 220
Associar registros correspondentes,
todos opo primria 220
Associar registros no
correspondentes 220
Associar, comparado com
Mesclar 234
Associar, comparar com
Relacionamentos 218
Associar, opo de registros
correspondentes 220
Associar, opes de sada 219
Associar, opes Um para muitos
do IMS 221
Ativar 120
Ativar reas de trabalho 120
Ativar arquivos de ndice 213
Atribuir 128
Atualizar 252
boto, usar 253
Atualizar dados ODBC no modo do
comando 252
Avaliar 176
Avaliar, confiabilidade,
informar 179
Avaliar, intervalo 179
Avaliar, parmetro Erros 180
Avaliar, parmetro Nmero de
erros 180
Avisos, pausa em batches 244
B
Batches
caixas de dilogo personalizadas,
criar 151
campos calculados, definir 145
comando grupo, processar 198
condies, especificar 168
criar 167
excluir no modo de
comando 150
executar 167
fechar 248
filtros, configurar 306
ndices, abrir 307
pausa para exibir mensagens 244
relacionamentos temporrios,
definir 268
renomear 270
Batches interativos, caixas de
dilogo 151
Batches interativos, criao 115
Benford 130
Benford, dgitos, especificar nmero
mximo 131
Benford, freqncia de, localizar 47
Benford, registros com valor
zero 132
Benford, registros de valores iguais a
zero 131
Benford, sada em grfico 132
Benford, valores positivos e
negativos, separar 131
Binrio 9
Binary 9
Bits
C
Cabo de conexo, unidade da
fita 357
Cadeias
de caracteres, dividir em
segmentos 79
posio inicial de byte ,
localizar 82
Cadeias com caracteres,
encontrados em outras cadeias
com caracteres 30
Cadeias de caracteres
ndice Remissivo
contagem de ocorrncias 65
isolar subcadeias 81
Caixa de seleo Clula, na caixa de
dilogo Amostra 283
Caixas de dilogo
caixas de texto, criao 116
com mltiplas solicitaes,
criar 120
comandos Perodo em, em
Perodo 123
de solicitao, criar 118
estrutura utilizando interface
grfica 152
listas suspensas, criar 116
tipo de solicitao nica,
criar 118
tipo solicitaes mltiplas,
criar 120
Caixas de texto, criar em caixas de
dilogo 116
Caixas de verificao, adicionar s
caixas de dilogo
personalizadas 157
Calcular 134
Calcular valores do campo em
expresses 135
Calculate 134
Clculos
mltiplos 134
Campo
modificadores. Consulte
Parmetros de comando
Campos
Chave, critrio de seleo do
comando Associar 221
chave, duplicidade 174
criar no modo de comando 144
data em branco, encontrando 11
deslocar para alinhar 191
incluir cadeias de caracteres 52
nomes de substituio 92
numrica, estratificao 328
ordem da posio inicial,
exibir 192
relacionado, usar no Construtor
de Expresses 263
renomear no modo de
comando 269
tipos, identificar 48
Campos calculados
379
final da cadeia 54
localizados em um registro 46
Caracteres imprimveis,
EBCDIC 15
Caracteres no-imprimveis,
localizar 36
Caracteres que no podem ser
impressos, verificando 29
Casas decimais, alterando
nmero 40
Categorias de dados 5
Classificar 136
Classificar, alternativa para
Ordenar 319
Classificar, execuo
automtica 136
Classificar, sada 137
Classificar. Consulte tambm
Resumir
Classify 136
Cliente/Servidor
arquivos relacionados 254
exportar arquivos 184
salvar arquivos na unidade
local 104
Close 140
COBOL
clusula OCCURS, ajustar
posio inicial 65
tipo de campo
computational-3 18
tipo de campo em campos
binrios 9
Cdigos de sculo
alterando campos de data
compactados 18
alterando padro 11
modificando o formato de
data 19
Comando
sada, salvar em um arquivo 98
Comandos
executar mais uma vez no fim do
arquivo 96
fechar loops 233
grupo, fechar 200
grupo, indentar 200
histrico, exibir 194
processar grupos 198
registrar, Definir Eco 305
380
ndice Remissivo
Count 143
Custom
tipo de campo, descrito 10
tipo de campo, utilizando em
aplicativos de idioma
estrangeiro 10
D
Dados
alinhados por byte, tipos de
campo a serem utilizados 15
bidirecionais, inverter a ordem de
exibio 84
caractere, descrito 5
categorias 5
data, caractersticas 5
de ponto flutuante IBM 16
fita, obtendo 357
lgicos, caractersticas 5
numrico, descrito 5
tipos de campos, equivalentes ao
ACL 7
Dados numricos
converter para formato sem
sinal 85
criar em formato compactado 66
em campos de caracteres 5
Tipo de campo BASIC 9
Dados numricos compactados
criar utilizando PACKED( ) 66
informaes sobre data 12
Data 11
comparaes, utilizar o comando
Perodo 124
constantes, usando nas
funes 28
exibir no modo de comando 167
retornos de valores negativos 28
Data piv, definida 11
Datas
americanas, convenes de
formatao 14
aspas, entre 11
Convenes de formatao
europia 14
Convenes de formatao
ISO 14
dia da semana, localizar 36
europias, conveno de
ndice Remissivo
formatao 14
formatando em campos
numricos comprimidos 12
julianas, conveno de
formatao 14
pesquisando intervalos 32
seriais, converter utilizando
funes 12
tipo serial 12
Date
dados armazenados como dados
de caractere 5
dados armazenados como dados
numricos 5
dados, caractersticas 5
formatos 13
formatos, definindo em campos
compactados 18
formatos, modificando o cdigo
de sculo 19
tipo de campo, descrito 11
dBASE
arquivos, abrir no modo do
comando 241
formato, dados ACL 183
Decimais
caractere ASCII equivalente 36
especificando em campos
compactados 18
implcito, em campos
numricos 17
Define Field 144
Define Report 148
Definio do arquivo de entrada
excluir no modo de
comando 150
Definio Exata, usando com
BETWEEN( ) 32
Definies de campo
armazenar nos arquivos da rea
de trabalho 290
Definies do arquivo de entrada
campos, adicionar no modo de
comando 144
Definir 303
Definir campo 144
Definir filtro 306
Definir histrico 306
Definir ndice 307
Definir perodo 123
381
avaliao de amostragem
monetria 178
tamanho da amostra, vantagens
de utilizar 310
Diviso, localizar resto 63
Do Batch 167
Documentar sesses do ACL 141
Dump 170
Duplicao de registros, remover do
arquivo. Consulte o comando
Resumir
Duplicadas, entradas, localizar 78
Duplicates 174
Duplicidade, campos-chave,
localizar 174
Duplicidades 174
Duplicidades, testar no comando
Seqncia 299
Duplicidades. Consulte tambm
Seqncia
E
EBCDIC 15
EBCDIC, caracteres imprimveis 15
EBCDIC, convertido de ASCII 42
EBCDIC, exibir usando comando
Descarregar 172
Else 175
Em branco
em campos de data 11
E-mail, enviar utilizando
Notificar 238
Emprstimo, perodos de
reembolso, calcular 64
Emprstimos
calcular pagamento mensal 67
calcular valor presente 68
Encontrar 297
Encontrar. Consulte tambm a
opo Buscar expresso do
comando Pesquisar
End 176
End of File 96
Enquanto
parmetro, utilizao 112
utilizao com o parmetro
Primeiros 99
Enviar e-mail utilizando
Notificar 237
382
ndice Remissivo
F
Falhas 197
Falhas, localizar em um dado 197
Falhas, testar, comando
Seqncia 299
Fechar 140
ndice Remissivo
compactados 18
Formatar
datas ou campos numricos em
modo de comando 107
Formato
arquivos, convertidos do
OS/390 352
ASCII, exibir usando o comando
Descarregar 171
converter numrico em
caractere 80
EBCDIC, exibir usando comando
Descarregar 171
exibir usando comando
Listar 227
hexadecimal, exibir usando o
comando Descarregar 171
sada, especificar 98, 111
Formato de caractere
convertendo em data 38
converter de expresses
numricas 80
converter para numrico 86
Formato delimitado por vrgula,
dados do ACL 183
Formato do relatrio HTML,
especificar 272
Formato Excel, converter dados do
ACL para 183
Formato listar, exibir sada 227
Formato Lotus 1-2-3, dados do
ACL 183
Formato numrico, converter de
caractere 86
Formato SDF no delimitado,
criar 229
Formato Word, dados do ACL 183
Formato WordPerfect, dados do
ACL 183
Freqncia de limite de erro
superior, amostragem de
registros 176
Freqncia de ocorrncia, avaliar
usando estatstica Z 88
Funo ALLTRIM( ) 29
Funo BIT ( ) 33
Funo BYTE ( ) 35
Funo CDOW( ) 36
Funo CHR( ) 36
Funo CLEAN( )
383
Funo REPLACE( ) 74
Funo REVERSE( ) 76
Funo RJUSTIFY( ) 76
Funo ROOT( ) 76
Funo ROUND( ) 77
Funo SHIFT( ) 77
Funo SOUNDEX( ) 78
Funo SOUNDSLIKE( ) 79
Funo SPLIT( ) 79
Funo STRING( ) 80
Funo SUBSTRING( ) 81
Funo TEST( ) 82
Funo TIME( ) 82
Funo TRANSFORM( ) 84
Funo TRIM( ) 84
Funo UNSIGNED( ) 85
Funo UPPER( ) 85
Funo VALUE( ) 86
Funo VERIFY( ) 87
Funo ZONED( ) 87
Funo ZSTAT( ) 88
Funo( ) ABSOLUTE 28
Funo( ) AGE 28
Funo( ) ASCII 29
Funo( ) AT 30
Funo( ) BETWEEN 32
Funo( ) BLANKS 35
Funes
de converso, resumo 23
diversas, resumo 23
financeiras, resumo 23
lgicas, resumo 23
matemticas, resumo 23
normalizar campos de chave 255
visualizar categorias no
Construtor de Expresses 23
Funes diversas, resumo 23
Funes financeiras 23
Funes matemticas, resumo 23
G
Gaps 197
Grfico
Consulte tambm Histograma
Consulte tambm Parmetro Para
Grfico de sada do comando
Estratificar 331
Graph 100
Group 198
384
ndice Remissivo
Grupo 198
Grupos
aninhados, criar 202
Comando Executar Batch,
utilizao 167
condicionais, criar 200
fechar comandos 176, 200
indentar comandos 200
Loop, comando 232
repetir processamento 232
Seno, comando 175
simples, criar 200
Variveis 202
H
Header 101
Help 203
Hexadecimal
exibir, usando comando
Descarregar 172
valor equivalente, localizar 51
Histogram 203
Histograma 203
Histograma, colunas,
especificar 205
Histograma, parmetro
Intervalos 205
Histograma, pontos iniciais e finais,
especificar 205
Histograma, valores,
determinar 245
Histogramas, criao em modo de
comando 209
Histrico
arquivo, entradas mximas 306
arquivo, excluir 150
arquivo, exibir 194
palavra-chave do comando
Definir 306, 307
Histrico do arquivo 194
Histrico do arquivo, entradas
mximas, definir 306
Hora, obter atual 82
I
If 102, 210
Ignorar, palavra-chave do comando
Listar 228
Import 210
Importar 210
Importar tabelas ODBC 210
Impresso
ndices, lista de 256
no modo de comando 108, 170
Imprimir
Consulte tambm Parmetro Para
IMS um para muitos, opo do
comando Associar 221
Index 211
Indexao
campos de chave,
Relacionamentos 256
comparada ordenao 212
no mod de comando 218
Indicadores de sinal,
hexadecimal 21
ndice 211
ndice, palavra-chave do comando
Definir 307
ndice. Consulte tambm Ordenar
ndices
abrir em batches 307
ativar 213
condicionais, criar 213
condicionais. Consulte o
comando Pesquisar
excluir no modo de
comando 150
filtros 213
ndices condicionais. Consulte o
comando Pesquisar
Informao ausente, localizar nos
campos 53
Informao invlida, substituir 74
Inicializao de variveis, funo
REPEAT( ) 74
Iniciar, opo da caixa de dilogo
Amostra 285
Incio, caixa de dilogo
Amostra 285
Inco da Data do Sculo 11
Inserir espaos em branco ou
caracteres em cadeias 52
Intervalo
Caixa de dilogo Amostra 284
Caixa de dilogo Avaliar 179
Intervalos de falha, informar,
comando Seqncia 300
J
Join 218
Justificar, direita, utilizando a
funo RJUSTIFY 76
K
Key 103
L
Largura
coluna, alterar no comando
Descarregar 171
modificador de campo,
utilizao 114
padro, alterar 114
Limite
data, especificar no comando
Perodo 124
parmetro, caixa de dilogo
Amostra 283
Limite de erro
comando Verificar,
especificar 342
Seqncia, comando 299
Limite de erro superior, em
amostragem monetria 176
Limite, superior e inferior no
comando Benford 131
Linguagem IBM PC, tipo de campo
BASIC 9
ndice Remissivo
funes, resumo 23
Lgico
caractersticas de dados 5
Loop
caixa de dilogo, exibir 232
palavra-chave Fim 233
M
Maisculo, converter de minsculo
ou mistura 85
Maisculo/minsculo, mudar 57
Manual de Instruo do ACL para
Windows 1
Marcas de arquivo
calcular nmero para saltar 337
definio 336
Materialidade, especificar no
comando Tamanho 311
Mximo
defeito tolervel, definido 309
valor do intervalo,
Estratificar 327
Memria, encontrando a
quantidade disponvel para
uso 166
Mensagens
Converses OS/390 349
criar com o comando Pausa 244
Merge 234
Mesclar 234
palavra-chave Pr-ordenar 237
Mesclar, caixa de seleo
Pr-ordenar 235
Mesclar, chaves, especificar 234,
235
Mesclar, comparado com
Associar 234
Mesclar, pr-requisitos 234
Mtodo clicar e arrastar para abrir
arquivos 261
Minsculos, converter de caracteres
alfabticos 57
Mistura de maisculo/minsculo,
converso para minsculo 68
Mistura maisculo/minsculo,
converter em minsculo 57
Modificador de campo Suprimir,
utilizao 110
Modificador de de campo de figura,
385
utilizao 107
Modo de comando, formatar datas
ou campos numricos em 107
MUS (amostragem de unidade
monetria)
Consulte tambm Amostragem de
unidade monetria
na caixa de dilogo do comando
Amostra 284
N
Name 104
No-atribudo, tipo de dados,
utilizando para dados alinhados
por byte 15
Next 105
Nodups 106
Nome
arquivo, alterar no modo de
comando 269
campo, alterar no modo do
comando 269
Consulte tambm Parmetro Para
parmetro, utilizao 104
Nome do Relacionamento, caixa de
dilogo Relacionamentos 260
Nome-da-exibio, sintaxe de
modo de comando 149
Normalizao de campos de dados
utilizando REMOVE( ) 73
Notificar 237
palavra-chave Senha 239
Notificar, aplicaes de e-mail da
Microsoft 238
Notificar, endereo, especificar 237
Notify 237
Nozeros 106
Numeric 17
Numrico
formato, converso para
zonado 87
tipo de campo, descrito 17
tipos de dados 5
Nmeros aleatrios, gerar 70, 249
Nmeros de dos registros atuais,
obter 72
386
ndice Remissivo
arquivos de formato,
utilizando 352
arquivos de relatrios,
utilizando 353
dados, converter para Projeto do
ACL 347
mensagens de erro de
converso 350
mensagens informativas sobre
converso 349
usando arquivos convertidos 351
O
ODBC
atualizar dados 252
senhas, criar 243
senhas, importar tabelas 210
tabelas de banco de dados,
importar 210
Opes
atualizar, comando
Descarregar 172
Sem repeties, na
amostragem 284
Opes da caixa de dilogo Amostra
Aleatrio 285
Clula 283
Extrair campos 284
Iniciar 285
Incio 285
Intervalo 284
Intervalo Fixo 284
Limite 283
MUS 284
Ordem de seleo de
relatrio 285
Populao 284
Registro 285
Subamostra 286
Tamanho 285
Open 107, 240
Ordem de classificao
ascendente 93
Comando Aleatrio 250
crescente ou decrescente 319
especificar 317
Ordem de ordenao, arquivos
indexados 212
Ordem de seleo de relatrio, caixa
de dilogo Amostra 285
Ordem, exibir campo 192
Ordenar 317
Ordenar, campos de chaves ou
expresses, selecionar 319
Ordenar, classificar alternativa 319
Ordenar, Comparar com
indexao 317
Ordenar, ordem, especificar 319
Ordenar, requisitos de espao 319
Ordenar. Consulte tambm ndice
OS/390
arquivos batch, utilizando 352
P
Packed 18
Pagamento, calcular valor
mensal 67
Page 107
Pgina
caixa de dilogo de configurao,
exibir utilizando o comando
Relatrio 273, 274
modificador de campo,
descrio 107
quebras, inserir no modo de
comando 107
Parmetro
Anexar/Anexar a um Arquivo
Existente 92
Arquivo 98
ascendente 93
Cabealho 101
Cabealho, em comparao com
a varivel cabealho 101
Campos, comando Aceitar 116
Chave 103
Chave. Consulte tambm Quebra
Como 92
Fim de arquivo 96
Grfico 100
Imprimir, descrio 108
Local 104
Nodups 106
Nozeros 106
Para 111
Para. Consulte tambm Grfico
Para. Consulte tambm Imprimir
Para. Consulte tambm Nome
Para. Consulte tambm Tela
Primeiros 99
Prximo 105
Quebra 94
Registro, utilizao 108
Se 102
Se, usar com filtro global 102
Se, utilizao com o parmetro
Primeiros 99
Suprimir outros 110
Tela 109
Tipo de arquivo 98
Tudo 91
Parmetro de data NDATE,
descrio 14
parmetro Usar Arquivo de Sada
Consulte tambm Abrir
Parmetros de escopo, limitar
processamento de registros com
Prximo 105
Parmetros de escopo, specificar
condio usando Enquanto 112
Password 243
Pausa 244
Pause 244
Perfil 245
Perfil de campos no modo de
comando 248
Perodo 123
Perodo, acumular campos 123
Perodo, sada 124
Perodos de reembolso de
emprstimo, calcular 64
Personalizado 10
Pesquisando, intervalo de
valores 32
Pesquisar 291
no modo comando 296
Pesquisar campos de chave em
arquivos indexados 212
Pesquisar expresso. Consulte
Localizar literal
Pesquisar, localizar expresses 293
Pesquisar, localizar nmeros de
registro 292
Pesquisar, parmetro Localizar
literal 292
Pesquisar, parmetro Localizar
Se 292
Pesquisar, usar arquivos de
ndice 212
PIC. Consulte Figura
ndice Remissivo
Picture 107
PL/1
tipo de campo comparado ao
numrico compactados 18
tipo de campo em campos
binrios 9
Placa controladora, exigncias do
sistema de fita 357
Ponto flutuante 15
Pontuao em campos
numricos 17
Populao
Caixa de dilogo Amostra 284
comando Tamanho,
especificar 311
Posio inicial do campo, ajustar 65
Posicionar no incio do arquivo 338
Preciso, fator de ajuste na
amostragem monetria 178
Pr-ordenar, comando
Resumir 333
Print 108
Print tipo de campo
comparado a numrico 20
decimais, implcito 20
Profile 245
Q
Quebra
campos de, especificao 94
Consulte tambm o parmetro
Chave
de pgina, inserir no modo de
comando 107
Quit 248
R
Raiz quadrada, calcular 76
RAM, exibe a quantidade disponvel
para uso 166
Random 249
Realinhar dados usando o comando
Deslocar Campos 191
Rebobinar fita
acelerando a velocidade 360
utilizar o comando Fita 338
Record 108
Reduzir tamanho de arquivo antes
da classificao 186
Refresh 252
Regenerar
amostras 280
comandos usados 194
Registrar comandos utilizando
Definir Eco 305
Registro
comprimentos, obter 71
nmero, obter atual 72
Opes da caixa de dilogo
Amostra 285
Registros
condicional, localizar 292
contar utilizando o comando
Estatsticas 322
contar utilizando o comando
Estratificar 326
contar, critrio 143
duplicaes, remover do arquivo.
Consulte o comando Resumir
especfico, buscar 230
incluir campos indefinidos na
sada 108
limitar processamento com o
parmetro Prximo 105
localizar no modo de
comando 195
nmero, localizar 292, 293
primeiro, localizar utilizando o
comando Encontrar 297
Registros correspondentes
Opo do comando Associar 220
todos os primrios e todos os
secundrios, opo de
comando Associar 220
todos primrios, opo de
comando Associar 220
todos secundrios, opo de
comando Associar 220
Registros no correspondentes,
opo de comando Associar 220
Relacionados
arquivos, registros ausentes ou
duplicados 254
campos, adicionar tela 265
campos, usar no Construtor de
Expresses 263
Relacionamentos 253
Relacionamentos entre arquivos,
387
planejar 257
relacionamentos mltiplos,
criar 261
Relacionamentos temporrios,
definir 268
Relacionamentos temporrios,
estabelecer 268
Relacionamentos, arquivo filho,
selecionar 261
Relacionamentos, arquivo pai, caixa
de dilogo Relacionamentos 261
Relacionamentos, arquivos
Cliente/Servidor 254
Relacionamentos, caixa de texto
Nome do Relacionamento 261
Relacionamentos, campos chave,
criar formato idntico 74
Relacionamentos, campos de chave,
escolher 255
Relacionamentos, comparado com
Associar 218
Relacionamentos, definir 268
Relacionamentos, excluir 266, 268
Relacionamentos, exibir 268
Relacionamentos, fechar arquivos
usando o comando Close 140
Relacionamentos, muitos para
um 254
Relacionamentos. Consulte
Relacionamentos
Relacionar arquivos,
procedimento 261
Relaes Muitos para Um entre,
arquivos pai e filho 254
Relations 253
Relatrio 272
Relatrio, caixa de dilogo de
configurao de pgina 274
Relatrio, resumo dos totais e
subtotais 274
Relatrio, suprimir linhas de detalhe
em branco 274
Relatrios
com vrias linhas, criar 274
criar no modo de comando 277
etapas de formatao 272
excluir totais especificados 110
exibio da largura,
especificar 114
imprimir no modo de
388
ndice Remissivo
comando 170
visualizar 273
zeros, suprimir 277
Relatrios com vrias linhas,
criar 274
Removendo caracteres dos
campos 44
Rename 269
Renomear 269
Report 272
Requisitos de espao, comando
Ordenar 319
Resto de diviso, isolar 63
Resumir 332
Resumir, acumular campos e
expresses 333
Resumir, arquivos grandes, gerar
totais 332
Resumir, boto Outros campos 334
Resumir, campos adicionais,
especificar 334
Resumir, campos ou expresses,
selecionar 334
Resumir, pr-ordenar arquivos 333
Resumir, totais do valor do
campo 332
Resumir, usando o comando
Classificar 136
Resumir. Consulte tambm
Classificar
Rodaps
alterar variveis de rodap 128
comparao entre o parmetro
rodap e a varivel rodap 100
inserir nos relatrios 100
S
Sada
anexar a um arquivo existente 92
Consulte tambm Parmetro Para
criar grficos 100
exibir em um grfico 100
exibir na tela 109
formato, especificar 98, 111
salvar em um arquivo
separado 98
Sair 248
Saltar, palavra-chave do comando
Fita 337
Salvar 290
Sample 278
Save 290
Screen 109
Se 102, 210
Search 291
Seek 297
Segmentar cadeias de caracteres 79
Sem sinal 22
Sem sinal, formato, converso de
dados numricos 85
Seno 175
Senha 243
Senha, comando Notificar 239
Senha, criar 243
Senha, ocultar 305
Senha, ODBC, importar tabelas 210
Sequence 298
Seqncia 298
Seqncia, campos, especificar 299
Seqncia, executar
automaticamente 298
Seqncia, intervalos de falhas,
relatrio 300
Seqncia, itens ausentes,
relacionar 300
Seqncia, nmero mximo de
erros, especificar 299
Seqncia, teste de
duplicidades 299
Seqncia, teste de falhas 299
Seqncia. Consulte tambm
Duplicidades
Seqncia. Consulte tambm Falhas
Set 303
Smbolos ASCII, acrescentar aos
campos, para formatao 36
Similaridades fonticas, localizar 79
Size 309
Soletrar, inconsistncias,
localizar 78
Solucionar problemas da fita 362
Soma total, calcular valor
presente 69
Sort 317
Statistics 322
Stratify 326
Subamostra, opo da caixa de
dilogo Amostra 286
Subcadeias, localizar em cadeias de
caracteres 81
Substituio comparada com
anexar 92
Subtotais, gerar com a opo de
quebra 94
Sumarizar 332
Summarize 332
Suppress 110
Suprimir
linhas de detalhes utilizando o
comando Relatrio 273, 274
linhas em branco utilizando o
comando Relatrio 273, 274
zeros nos relatrios 277
T
Tamanho 309
Tamanho da amostra
amostra do atributo, gerar 310
calculando no modo de
comando 317
determinar 309
distribuio de Poisson,
vantagens de utilizar 310
Tamanho, alterar 85
Tamanho, amostragem do registro,
especificar 311, 313
Tamanho, limite superior de erro,
especificar 311
Tamanho, materialidade,
especificar 311
Tamanho, populao,
especificar 311
Tamanho, taxa de erro prevista,
especificar 311
Tamanho, tipo de amostragem
monetria, especificar 311, 312
Tamanho, total de erros previsto,
especificar 311
Tape 336
Taxa de erro prevista, especificar no
comando Tamanho 311
Taxa de juros nominal, calcular 63
Taxa, calcular juros sobre a
anualidade 70
Taxas de juros
efetiva anual, calculando 43
nominal, calcular 63
sobre anualidade, calcular 70
ndice Remissivo
Tendncia, seleo de
amostragem 278
Teste Se em grupos, comando
Seno 175
Teste, criar usando comando
Se 210
Texto
formatar dados do ACL 183
mensagens, adicionar s caixas de
dilogo 156
Tipo de Amostra 279
Tipos de campos
ACCPAC 8
ACL 8
ACL, definido
automaticamente 8
ACL, e equivalentes de tipo de
dados comuns 7
BASIC 9
binrio 9
compactados 18
COMPUTATIONAL-1 em
campos binrios 9
custom 10
date, descrito 11
EBCDIC 15
float 15
halfbyte 15
IBMfloat 16
identificar 48
Logical 16
micro 17
numrico 17
PCASCII 20
Print 20
reconhecidos por ACL 6
sobre 6
sobrepor 144
Unisys 21
unsigned 22
utilizando campos calculados
para converter 6
utilizando funes para
converter 6
VAXfloat 22
zoned 22
Tipos de campos ACL, equivalentes
a tipos de dados comuns 7
Tipos de campos ACL, equivalentes
ao tipo dos dados fonte 7
To 111
Top 338
Total 338
Total de erros previsto, especificar
no comando Tamanho 311
Total, campos numricos e
expresses, exibir 339
Total, excluir fora do intervalo
especificado 110
Total, executar
automaticamente 338
Total, grupo, utilizar 338
Totalizar campos numricos no
modo de comando 341
Tudo, parmetro 91
U
Unidade local, salvar arquivos do
servidor 104
Unsigned, tipo de campo 22
Usar Arquivo de Sada 112
Use Output File 112
Utilitrio
ACL 347
software, sistema de fita 357
V
Validade
dados, testar utilizando o
comando Verificar 343
dos dados, teste utilizando a
funo VERIFY 87
erros, localizar utilizando o
comando Verificar 341
Valor absoluto
calculado utilizando a funo
ABSOLUTE( ) 28
localizar utilizando o comando
Estatsticas 322
Valor do intervalo mnimo,
comando Estratificar 327
Valor exponencial, localizar 44
Valor futuro
anualidade, calcular 49
investimento, calcular 50
Valor inteiro da expresso numrica
ou campo. 53
Valor logartmico, calcular 56
389
Valor presente
da soma total, calcular 69
dos emprstimos, calcular 68
Valores de campo, comparar
usando MATCH( ) 60
Valores maiores/menores,
comando Estatsticas 323
Valores repetidos, exibidos como
espaos em branco 106
Valores zero, exibir como espaos
em branco 106
Valores, calcular usando o comando
Calcular 134
Variveis
alterar valores 128
grupo de comandos, usar 202
nomes, substituir 128
resultados armazenados em
campos ACL 8
teste usando comando Se 210
valores, exibir no modo de
comando 166
Vencimento, usando as funes
para calcular 28
Verificar 341
Verificar, especificar campos ou
expresses 343
Verificar, executar
automaticamente 341
Verificar, limite de erro 342
Verify 341
Visualizar formato do relatrio 273
W
While 112
Width 114
Z
Zeros
esquerda, filtrar 55
arquivos relacionados,
origem 254
Zonado 22
Zonado formato, converso de
numrico 87
Zoned, tipo de campo 22
390
ndice Remissivo
As Amricas
+1-604-669-4997
+1-604-689-4209
support@acl.com
ACL
Verso
7
Manual de Referncia
AWDP107087
ACL
50 Kallang Avenue
#07-05 Noel Corporate Building
Singapore 339505
Tel: +65-299-3350 Fax: +65-299-5110
E-mail: info_asia@acl.com Web: www.acl.com
para Windows
Manual de Referncia
Verso